breakdown-epic

breakdown-epic

既存のEpic mdから個別Story mdへブレイクダウンするスキル。 出力された個別Story md群は、そのまま register-story に渡してタスクツール登録に進める。

実行手順

1. Epicファイルの読み込み

引数で渡されたEpic mdファイルパスを Read で読み込む。 パスが渡されていない場合、docs/plans/*.md を Glob で列挙してユーザーに選ばせる。

2. Epic構造の解析

ファイル内容から以下を抽出:

• YAMLフロントマター（type=epic か確認、なくても続行可能）
• Epic ID / タイトル
• Story候補となるセクション（H2見出し、表内のStory項目、リスト項目等）

Epic内のStory候補を見つけるパターン:

• H2 / H3 見出しのうち「Story」「機能」「タスク」を含むもの
• 「Story一覧」表の各行
• 「やること」「ToDo」リスト内の項目
• mermaid図のノード

これらから候補リストを作り、ユーザーに確認する。AskUserQuestion で 「以下のStory候補で抽出を進めるか？修正があれば指摘してほしい」と提示。

3. 各Storyへの情報マッピング

各Story候補について、Epic md内から関連情報を集約する:

• タイトル、概要
• 受け入れ基準があれば抽出
• リスクサマリーで該当Storyに紐づくものがあれば抽出
• 依存関係があれば抽出

情報が不足するStoryは、ユーザーに補完情報を求めるか、空欄のまま生成して 「TODO」フラグを立てる。

4. Story mdファイルの生成

${CLAUDE_PLUGIN_ROOT}/templates/story.md を雛形として、各StoryごとにmdファイルをWrite。

出力先: 設定ファイルの output.story_dir（デフォルト docs/plans/stories）

ファイル名規則:

• Story IDが既存なら <story-id>.md
• なければ kebab-case のタイトルから生成（例: add-oauth-login.md）
• 衝突したら -2, -3 を付与

各Story mdのフロントマター:

• type: story
• id: <生成したID>
• epic: <Epic ID>
• status: planning
• points: 0（未見積もり）
• 既知の値があれば反映

5. Epic mdの更新

元のEpic mdに「Story一覧」表が無いなら追加し、各Storyへのリンクと ステータスを記載する。既にある場合は最新化する。

依存関係図（Mermaid）も Epic 内で更新する。Story候補から識別できる依存があれば 矢印を追加。判断できないものは「TODO」コメントを残す。

6. 次のステップ案内

生成したStoryファイルパス一覧を表示し、以下を案内:

• 未見積もりStoryに /planning-skills:estimate-points を実行
• リスク識別に /planning-skills:identify-risks を実行
• タスクツール登録に /planning-skills:register-story を実行

注意事項

• 元Epic mdのバックアップは作らないが、書き換える前に変更内容をユーザーに提示し承認を取る
• Story mdが既存（同名ファイル）の場合、上書きせずスキップ or マージをユーザーに確認
• Epic md内の他のセクション（インセプションデッキ、ユースケース等）は破壊しない
• 抽出元の出典（元Epic mdの該当セクションへの参照）を各Story mdの「メモ」欄に残す
• Story候補を抽出できない（情報が薄い）場合は、decompose-stories に切り替えるよう案内する