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

python3 skills/epic/decompose/epic_decompose.py

With Arguments

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:

name: my.agent
skills_available:
  - epic.decompose

Testing

Run tests with:

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

2.2 KiB Raw Permalink Blame History