資料やユーザー要件を分析し、フェーズごとに分割されたアトミックな粒度の行動計画をマークダウンファイル群として出力する。Use when 行動計画の作成、タスク分解、実装計画の策定、資料からの計画立案を求められた際に使用する。
引数として渡された資料 (ファイル、URL、PR、設計書等) を分析し、アトミックな粒度のタスクに分解した行動計画を作成する。
必須: 作業開始前に TaskList で残存タスクを確認し、存在する場合は全て TaskUpdate({ status: "deleted" }) で削除する。その後、TaskCreate ツールで以下のステップをタスクとして登録する:
TaskCreate({ subject: "資料の読み込みと分析", description: "引数として渡された資料を読み込み、スコープと要件を把握", activeForm: "資料を分析中" })
TaskCreate({ subject: "要件の明確化", description: "不明点を AskUserQuestion でインタビューし、要件を明確化", activeForm: "要件を明確化中" })
TaskCreate({ subject: "出力先の確認", description: "AskUserQuestion で行動計画の出力先を尋ねる", activeForm: "出力先を確認中" })
TaskCreate({ subject: "アトミックなタスクへの分解", description: "資料をアトミックな粒度のタスクに分解し、実行主体を分類", activeForm: "タスクを分解中" })
TaskCreate({ subject: "依存関係の整理とフェーズ構成", description: "タスク間の依存関係を整理し、フェーズにまとめる", activeForm: "フェーズを構成中" })
TaskCreate({ subject: "行動計画の出力", description: "フェーズごとにファイルを分割して出力", activeForm: "行動計画を出力中" })
TaskCreate({ subject: "レビューと修正", description: "ユーザーのフィードバックに基づき行動計画を修正", activeForm: "行動計画を修正中" })
TaskCreate({ subject: "完了報告", description: "作成ファイル一覧、タスクサマリー、クリティカルパスを報告", activeForm: "完了報告を作成中" })
各ステップの開始時に TaskUpdate で in_progress に、完了時に completed に更新する。
引数として渡された資料を読み込み、全体像を把握する:
gh pr view と gh pr diff で概要と差分を取得資料から以下を抽出する:
資料を分析した結果、不明点や曖昧な箇所がある場合は AskUserQuestion でユーザーにインタビューする。不明点がなくなるまで以下のサイクルを繰り返す:
質問の観点:
不明点がない場合はこのステップをスキップする。
AskUserQuestion で行動計画の出力先を尋ねる。選択肢の例:
.claude/plans/: プロジェクト内の計画専用ディレクトリdocs/plans/: ドキュメントディレクトリ配下出力先ディレクトリが存在しない場合は作成する。
資料の内容をこれ以上分割できない最小かつアトミックな粒度のタスクに分解する。
各タスクを以下のいずれかに分類する:
手動タスクには必ず具体的な手順を記載する。
各タスクの最後に検証可能な完了条件を必ず記載する。自動検証 (テスト、Lint、ビルド、型チェック) を優先し、自動化が困難な場合のみ手動検証とする。手動検証の場合は確認手順と期待結果を詳細に記載する。
具体的な記述パターンは references/plan-format.md の「完了条件の記述パターン」を参照。
タスク間の依存関係を明らかにする:
depends_on で明示依存関係はタスク ID (例: T1, T2) で参照する。
関連するタスクをフェーズにまとめる:
フェーズごとにファイルを分割して出力する。
<出力先>/
├── 00-overview.md # 全体概要、フェーズ一覧、前提条件
├── 01-phase-name.md # フェーズ 1 のタスク一覧
├── 02-phase-name.md # フェーズ 2 のタスク一覧
├── ...
└── NN-phase-name.md # フェーズ N のタスク一覧
各ファイルのフォーマットは references/plan-format.md を参照。
行動計画を出力後、ユーザーにレビューを依頼する。フィードバックがある場合は修正サイクルを繰り返す:
ユーザーが承認した場合、次のステップに進む。
全ファイル出力後、以下を報告する:
Step 4-6 でタスクを設計・出力する際に参照:
references/plan-format.md - 全体概要・フェーズファイル・タスクの記述フォーマット、サンプル