実装計画（Plan）ファイルを作成する。TDD・コミット分割・テストケース一覧・工数見積もりを含む再現性の高い Plan を生成する。機能追加・バグ修正・リファクタリング等の実装計画策定時に使用。トリガー: 「Planを作って」「計画を立てて」「実装計画を」
あらゆるテックスタックで使える、再現性の高い実装 Plan ファイルを作成する。
Plan 作成前に以下が揃っていること。揃っていなければユーザーに確認:
AGENTS.md や CLAUDE.md 等から読み取り）docs/<プロジェクト略称>/plan-<topic>.md
以下をこの順序で含めること。セクションの省略は禁止。
# Plan: <タイトル>
<1-2文で何を実装するか>
> **Note**: 以下の具体的なコード例・API 設計・構成（How）はあくまで参考である。実装時によりよい設計方針があれば積極的に採用すること。
Note は必ず含める。How に固執しないことを宣言する。
3-5 個の箇条書き。参考にした外部実装・既存パターンがあれば明記。技術的な意思決定（なぜこのアプローチか）を含める。
WT作成 → 実装(TDD) → コミット(意味ごとに分離) → PR作成
Worktree を使用しない場合は WT作成 を省略。
テーブル形式で何を対象にするかを一覧化。
各 Step は 必ず 以下の構成:
## Step N: <モジュール名> (TDD)
### RED: テスト先行
| テストケース | 内容 |
|---|---|
| `test_name` | <検証内容> |
### GREEN: 実装
<概要。コード例は参考レベル>
### コミット
`<type>: <description>`
テストを最後にまとめる Step は禁止。 各 Step が独立して RED → GREEN → コミットを完結する。
テストケースの網羅性は references/test-coverage.md を参照。
テーブル形式。**新規** / 変更 を明記。
Conventional Commits 形式。1 コミット = 1 論理的変更。対象ファイルを併記。
(X) を記載全 N 件 を記載Step ごとに 行数 で見積もる。テストコードも含む。合計行数を明記。
assets/plan-template.md に空のテンプレートがある。docs/ 配下にコピーして使用。
| 落とし穴 | 対策 |
|---|---|
| テストが最後にまとまっている | 各 Step に RED → GREEN を組み込む |
| エッジケースのテスト不足 | 空・null・大文字小文字・境界値を必ず含める |
| コードが詳細すぎる | 参考レベルにとどめ実装者に判断を委ねる |
| Step 間の依存が不明 | 依存する Step に「前提: Step N」を明記 |
| 工数見積もりが抽象的 | 行数で具体的に見積もる |