build

実装（Build）

plan.md に沿って実装を進める。progress.md で中断・再開をサポートする。

入力: docs/plans/{feature-name}/plan.md 状態管理: docs/plans/{feature-name}/progress.md 出力: 実装コード

パスルール: docs/plans/{feature-name}/ はカレントディレクトリ直下。{feature-name} は英語の kebab-case

タスク状態

progress.md の状態列で管理する: -（未着手）/ →（実施中）/ ✓（完了）

重要: plan.md は読み取り専用。状態更新は progress.md に対して行う。

ワークフロー

Step 0: 読み込み + 再開検知
Step 1: タスク選択
Step 2: feature ブランチ作成（新規開始時のみ）
Step 3: タスク順の実装
Step 4: ビルド確認

---

Step 0: 読み込み + 再開検知

Read docs/plans/{feature-name}/plan.md
Read docs/plans/{feature-name}/progress.md

いずれか存在しない場合は「先に /spec で設計・実装計画を作成してください」と案内して終了。

progress.md のタスク状態から判定:

• 全て - → 新規開始: Step 1 へ
• ✓ や → あり → 再開: 実装状態と progress.md を突合し、再開ポイントを提示

---

Step 1: タスク選択

plan.md のタスク一覧を表示し、AskUserQuestion で確認:

• 「全タスクを実行する」→ Step 2 へ
• 「実装するタスクを選択する」→ タスク番号を選択させる。依存先が未選択なら警告して自動追加

---

Step 2: feature ブランチ作成

現在のブランチを表示し、AskUserQuestion でベースブランチを確認:

• 「現在の {branch} から切る」
• 「別のブランチから切る」→ ブランチ名を入力

ブランチ名を確認（デフォルト: feature/{feature-name}）して git checkout -b で作成。

---

Step 3: タスク順の実装

選択されたタスクを依存関係順に処理する。

各タスク:

1. progress.md の状態を → に更新
2. plan.md の該当セクションを参照して実装
3. 完了後、状態を ✓ に更新

外部ライブラリの利用

外部ライブラリのAPIを使う際、使い方やパラメータに確信がなければ 実装前に WebSearch で公式ドキュメントを確認する。学習データが古い可能性があるため、バージョン固有の破壊的変更に特に注意すること。

仕様矛盾検知

仕様書と実際のコードで矛盾が見つかった場合、ユーザーに提示して選択させる:

• plan.md を修正してから再開
• 実装側を仕様に合わせる
• このまま進めて後で対応

---

Step 4: ビルド確認

plan.md の「ビルド確認」セクションのコマンドを実行。エラーがあれば修正 → 再実行。

AskUserQuestion で手動検証の結果を確認:

• 「問題なし、完了」→ 終了
• 「不具合がある」→ /fix を案内
• 「仕様との整合性を確認したい」→ /check を案内