87 lines
2.2 KiB
Markdown
87 lines
2.2 KiB
Markdown
# 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*
|