# epic.decompose

Take an Epic (as Markdown) and decompose it into user stories. Analyzes Epic document and identifies major deliverables, grouping them by persona or capability.

## Overview

**Purpose:** Take an Epic (as Markdown) and decompose it into user stories. Analyzes Epic document and identifies major deliverables, grouping them by persona or capability.

**Command:** `/epic/decompose`

## Usage

### Basic Usage

```bash
python3 skills/epic/decompose/epic_decompose.py
```

### With Arguments

```bash
python3 skills/epic/decompose/epic_decompose.py \
  --epic_file_(string,_required):_path_to_the_epic.md_file_to_decompose "value" \
  --max_stories_(integer,_optional):_maximum_number_of_stories_to_generate_(default:_5) "value" \
  --output_path_(string,_optional):_where_to_save_the_stories.json_file_(default:_./stories.json) "value" \
  --output-format json
```

## Inputs

- **epic_file (string, required): Path to the epic.md file to decompose**
- **max_stories (integer, optional): Maximum number of stories to generate (default: 5)**
- **output_path (string, optional): Where to save the stories.json file (default: ./stories.json)**

## Outputs

- **stories.json: Structured JSON list of story summaries with persona, goal, benefit, and acceptance criteria**

## Artifact Metadata

### Consumes

- `agile-epic`

### Produces

- `user-stories-list`

## Examples

- python3 skills/epic.decompose/epic_decompose.py --epic-file ./epic.md --max-stories 5

## Permissions

- `filesystem:read`
- `filesystem:write`

## Implementation Notes

Parse Markdown structure to extract Epic components. Use NLP techniques to identify distinct user stories. Ensure stories are independent and testable (INVEST criteria). Generate meaningful acceptance criteria. Validate output against JSON schema. Include metadata for traceability to source Epic.

## Integration

This skill can be used in agents by including it in `skills_available`:

```yaml
name: my.agent
skills_available:
  - epic.decompose
```

## Testing

Run tests with:

```bash
pytest skills/epic/decompose/test_epic_decompose.py -v
```

## Created By

This skill was generated by **meta.skill**, the skill creator meta-agent.

---

*Part of the Betty Framework*