implementation-plan

name	implementation-plan
description	実装計画（Plan）ファイルを作成する。TDD・コミット分割・テストケース一覧・工数見積もりを含む再現性の高い Plan を生成する。機能追加・バグ修正・リファクタリング等の実装計画策定時に使用。トリガー: 「Planを作って」「計画を立てて」「実装計画を」

Implementation Plan スキル

あらゆるテックスタックで使える、再現性の高い実装 Plan ファイルを作成する。

前提

Plan 作成前に以下が揃っていること。揃っていなければユーザーに確認:

1. 対象スコープ: 何を実装するか
2. コードベース理解: 既存の該当ファイル・パターンを把握済み
3. 技術スタック: 言語・フレームワーク・テストフレームワークが判明
4. 制約条件: 既存規約・アーキテクチャ制約が判明（AGENTS.md や CLAUDE.md 等から読み取り）

Plan ファイルの配置先

docs/plan/plan-<topic>.md (実装済みのPlanは、docs/plan/archived/に移動)

Plan ファイルの必須構造（12 セクション）

以下をこの順序で含めること。セクションの省略は禁止。

1. ヘッダー

# Plan: <タイトル>

<1-2文で何を実装するか>

> **Note**: 以下の具体的なコード例・API 設計・構成（How）はあくまで参考である。実装時によりよい設計方針があれば積極的に採用すること。

Note は必ず含める。How に固執しないことを宣言する。

2. 設計方針

3-5 個の箇条書き。参考にした外部実装・既存パターンがあれば明記。技術的な意思決定（なぜこのアプローチか）を含める。

3. Plan スコープ

WT作成 → 実装(TDD) → コミット(意味ごとに分離) → PR作成

Worktree を使用しない場合は WT作成 を省略。

4. 対象一覧

テーブル形式で何を対象にするかを一覧化。

5-N. Step（TDD サイクル）

各 Step は 必ず 以下の構成:

## Step N: <モジュール名> (TDD)

### RED: テスト先行
| テストケース | 内容 |
|---|---|
| `test_name` | <検証内容> |

### GREEN: 実装
<概要。コード例は参考レベル>

### コミット
`<type>: <description>`

テストを最後にまとめる Step は禁止。 各 Step が独立して RED → GREEN → コミットを完結する。

テストケースの網羅性は references/test-coverage.md を参照。

動作確認 Step

• 全テスト通過コマンド
• Lint / フォーマット / 型チェック

PR 作成 Step

変更ファイル一覧

テーブル形式。**新規** / 変更 を明記。

コミット分割

Conventional Commits 形式。1 コミット = 1 論理的変更。対象ファイルを併記。

テストケース一覧

• 全テストケースに 連番 を振る
• モジュールごとにグループ化
• グループ名に件数 (X) を記載
• セクションヘッダーに 全 N 件 を記載

工数見積もり

Step ごとに 行数 で見積もる。テストコードも含む。合計行数を明記。

テンプレート

assets/plan-template.md に空のテンプレートがある。docs/ 配下にコピーして使用。

よくある落とし穴

落とし穴	対策
テストが最後にまとまっている	各 Step に RED → GREEN を組み込む
エッジケースのテスト不足	空・null・大文字小文字・境界値を必ず含める
コードが詳細すぎる	参考レベルにとどめ実装者に判断を委ねる
Step 間の依存が不明	依存する Step に「前提: Step N」を明記
工数見積もりが抽象的	行数で具体的に見積もる