05. 複数の Task に分けて処理する (general cycle · medium/large)
Guide読了目安 6分
次のいずれかに該当すると、 ywc-plan はこの経路へ routing します。
規模で選ぶ
04. 小さな変更を処理する (general cycle · small)ywc-plan がリクエストを Small と判断したとき、自動的にこの経路に入ります。判断基準は「Task 分解なしで単一 PR に収められるか」であり、以下のいずれかに該当すると Small ではなく Medium/Large に格上げされます ( 05 参照)。現在のページ05. 複数の Task に分けて処理する (general cycle · medium/large)次のいずれかに該当すると、 ywc-plan はこの経路へ routing します。06. 目標 1 つで自動完了する (ywc-agentic)04 , 05 は、各段階( ywc-plan → ...
05. 複数の Task に分けて処理する (general cycle · medium/large)
いつこのフローを使うか
次のいずれかに該当すると、ywc-plan はこの経路へ routing します。
- 変更内容をレビュー可能な単一 PR 1 つに収めるのが難しい (複数画面、複数 API、複数 subsystem)
- DB migration が含まれる (規模に関係なく常にこの経路 — 安全不変式)
- 新 Library/Framework 導入が含まれる (これも常にこの経路)
全体フロー
guidebook
ywc-plan → ywc-spec-ready → ywc-task-generator → ywc-sequential-executor --review または ywc-parallel-executor --review| 段階 | Skill | 役割 |
|---|---|---|
| 1 | ywc-plan | リクエストを分析して docs/ywc-plans/<slug>.md spec を生成 |
| 2 | ywc-spec-ready | spec が DONE になるまで ywc-plan --update-spec ↔ ywc-spec-validate を自動反復 |
| 3 | ywc-task-generator | DONE になった spec を dependency-safe な複数 Task に分解 (tasks/<phase>-<sequence>-<slug>/) |
| 4 | ywc-sequential-executor または ywc-parallel-executor | Task を実際に実装 → PR → Merge |
Sequential vs Parallel の選択基準
| 状況 | 選択 |
|---|---|
| Task 間の順序が重要、または互いの成果物に依存する | ywc-sequential-executor |
Task 同士が独立しており、dependency-graph.md 上で並列実行可能な wave にまとまる | ywc-parallel-executor (Git Worktree で隔離) |
実行例
claude code
ywc-plan ユーザーが通知の種類ごとにオン/オフを切り替えられる設定画面と API が必要。メール/プッシュ/アプリ内の 3 チャンネルに対応codex
ywc-plan ユーザーが通知の種類ごとにオン/オフを切り替えられる設定画面と API が必要。メール/プッシュ/アプリ内の 3 チャンネルに対応claude code
ywc-spec-ready --spec docs/ywc-plans/notification-settings.mdcodex
ywc-spec-ready --spec docs/ywc-plans/notification-settings.mdclaude code
ywc-task-generator --lang kocodex
ywc-task-generator --lang ko以降の実行 command はオプションが多いため、別ページで扱います → 16. Executor / Code-gen Prompt パターン。最も単純な開始は以下です。
claude code
ywc-sequential-executor --reviewcodex
ywc-sequential-executor --reviewtask 指定を省略すると、dependency-graph.md から次に実行可能な Task を自動で探します。
--review を必ず付けてください
両 executor とも --review flag によって、各 Task の PR 作成/merge 前に /ywc-impl-review を自動実行します。この flag なしで実行すると、04 の small cycle と同様にレビュー段階が完全に抜けます。付けない理由はありません。(ただし、Task の Criticality: critical が設定されている場合は flag の有無に関係なく常に強制実行されます。)
各段階で詰まったとき
| 状況 | 対応 |
|---|---|
ywc-spec-ready が iteration 上限に達した | 自動収束できない根本的な spec 問題 — 部分レポートを読み、直接 spec を修正 |
ywc-task-generator が Task を 20 個以上作ろうとする | spec 自体が過大であるサイン — まず spec 分割を検討 |
| Task 実行中に dependency がまだ完了していない | executor が自動で停止し、どの Task が先行する必要があるか報告する |