| name | implement |
| description | 実装契約を受け取り、bootstrap 確認、vertical slice 分割、TDD loop、slice gate、completion handoff まで進める。 interview-with-docs / design-and-plan / issue / plan から実装可能な契約を受け取り、PR やふりかえりではなくローカル実装を完了したいとき。
|
implement — TDD で実装して閉じる
実装契約を、観測可能な vertical slice に分け、各 slice を TDD で通してから handoff します。
この skill は実装フェーズだけを扱います。PR 作成、PR review 対応、pre-PR review、furikaeri は別 skill に任せます。
こんなときに使う
- 実装契約からローカル実装を始めたいとき
- 受け入れ条件を vertical slice に分けたいとき
- TDD の RED/GREEN/REFACTOR を崩さず進めたいとき
- slice ごとに evidence gate を通したいとき
- 実装完了後に handoff だけ残して閉じたいとき
Core Loop
implementation contract
-> bootstrap check
-> slice contract
-> RED
-> GREEN
-> REFACTOR
-> slice gate
-> next slice or completion handoff
ワークフロー: TDD で実装して閉じる
ステップ 1 — 実装契約を確認する
次が揃っていれば実装に入ります。不足が実装判断をブロックする場合は、interview-with-docs または design-and-plan に戻します。
- 目的、対象、非対象
- 受け入れ条件
- 主要な user-visible behavior または外から観測できる contract
- handoff に
artifacts: フィールドがある場合は、その意味（保存済み path か conversation-only か）
- 実行する test / build / launch command
- 失敗時の戻り先:
FAIL は実装修正、REPLAN_REQUIRED は前段へ戻す
実装に不要な設計議論をここで広げません。必要十分な契約に圧縮してから進みます。
ステップ 2 — bootstrap を軽く確認する
対象 repo で次を確認します。
- repo instructions、local hooks、workflow の有無
- git 管理状態
- build / test / launch command
- interactive app なら
references/interactive-app-bootstrap-checklist.md
- 複数リポで
plan.md の dependencies.contracts.requires がある場合だけ、checkpoints/contract_verify.py で required artifact を検証する
- handoff に
artifacts: フィールドがあり path が列挙されている場合は、その file が repo に存在することを確認する。存在しない場合は REPLAN_REQUIRED として design-and-plan に戻す。artifacts: conversation-only、または旧形式でフィールド自体が無い場合はこの確認をスキップする
bootstrap の不足が今の slice を壊すなら修正します。関係ない整備は実装 scope に混ぜません。
ステップ 3 — slice contract を固定する
1 受け入れ条件、または 1 ユーザー行動を 1 vertical slice として切ります。最初の slice は tracer bullet として、必要な層を薄く縦断します。
各 slice で必ず短く固定すること:
- 対象振る舞い
- 非対象
- public interface 経由の確認観点
- 最初に追加または更新する test
RED を確認する command と期待する失敗理由GREEN を確認する command- acceptance command
層ごとに「DB だけ」「UI だけ」「テストだけ」を横に広げる horizontal slice は避けます。
ステップ 4 — TDD loop を回す
各 slice は次の順で進めます。
- RED: 失敗する test を 1 つ書く。失敗理由が対象振る舞いと一致することを確認する。
- GREEN: その test を通す最小実装だけを入れる。
- REFACTOR: 振る舞いを変えずに読みやすさ、重複、境界を整える。
- 次の test が必要なら同じ slice 内で繰り返す。
TDD の規律:
- 1 test → 1 minimal implementation を守る
- test は public interface 経由の振る舞いを主語にする
- private method や内部 collaborator の呼び出し回数を固定しない
- mock は外部 API、時刻、乱数、ファイル I/O、コマンド実行など system boundary に限る
- speculative code を足さない
- all tests first の horizontal slicing をしない
docs-only / config-only など RED が成立しない slice では、TDD を装いません。代わりに verification command と期待結果を slice contract に明記します。
ステップ 5 — slice gate で評価する
各 slice の最後に、実装者の自己正当化ではなく証拠として gate を通します。
- RED を実際に見たか
- RED の失敗理由は対象振る舞いと一致したか
- GREEN を実際に見たか
- acceptance command は通ったか
- public interface 経由で確認しているか
- speculative code、不要な抽象化、過剰な mock を入れていないか
- contract と違う発見があれば
FAIL か REPLAN_REQUIRED に分類したか
verdict:
PASS: 次の slice へ進むFAIL: 同じ slice の実装に戻るREPLAN_REQUIRED: interview-with-docs または design-and-plan に戻る
必要なら plugins/happy-coding/skills/implementation-eval-gate/SKILL.md を独立評価として使います。ただし、この skill 内では slice gate を最小の必須評価として扱います。
ステップ 6 — completion handoff で閉じる
全 slice が PASS したら、実装フェーズを閉じます。
handoff に残すもの:
- 完了した slice
- 実行した command と結果
- 変更した主な file / artifact
- 確認に使った design / plan artifact path
- 残件、または明示的に対象外にしたもの
- 次に開く file または確認 command
- 戻り先 skill がある場合はその理由
docs/plan/NNN_PLAN.md が今回の実装 plan なら、完了時に docs/plan/NNN_PLAN_DONE.md へリネームします。未完了項目が残る場合は、次の plan または handoff に切り出します。
注意点
- 実装中に仕様の穴を埋めない。判断が必要なら前段へ戻す。
- phase / slice は自動停止点ではない。blocker、HITL 判断、
REPLAN_REQUIRED がなければ次へ進む。
- 並列化する場合も、各 worker に slice contract と TDD loop を渡す。未確定の slice を並列化しない。
- PR、review、furikaeri はここで扱わない。必要になった時点で別 skill を起動する。
共通リソース
references/interactive-app-bootstrap-checklist.md — interactive app の bootstrap 前提references/interactive-app-comparable-harness-contract.md — interactive app の比較前提checkpoints/contract_verify.py — 複数リポ環境での contract 検証plugins/happy-coding/skills/implementation-eval-gate/SKILL.md — 必要時の独立評価
