TDD × Claude Code — Red-Green-Refactor を Claude に自動運転させる

Anthropic が公式に推奨するワークフローの一つが TDD（Test-Driven Development）。Claude Code は「失敗するテストを書く → 実装で通す → リファクタ」の Red-Green-Refactor を自律的に回せるため、「TDD は面倒で続かない」を「TDD が最も速い」に変える力がある。本稿は公式ベストプラクティスと bundled skill `test-driven-development` の使い方を整理する。

なぜ Claude Code と TDD は相性が良いか

Claude Code 公式 Best Practices に明記の原則：

Include tests, screenshots, or expected outputs so Claude can check itself. This is the single highest-leverage thing you can do.

Claude は「正解の判定基準」があると劇的に良くなる。テストはまさにその判定基準で、テストを先に書く行為は Claude にゴールを渡すことに等しい。

3 段階のセットアップ

1. 「TDD でやる」と明示する

Claude は曖昧な指示だと mock を作って「動いた」と言いがち。公式が警告：

it's crucial to be explicit that you are doing TDD, which helps Claude avoid creating mock implementations or stubbing out imaginary code prematurely.

2. bundled skill `test-driven-development` を呼ぶ

/test-driven-development implement a JWT validator that ...

Skill が Red-Green-Refactor サイクルを自動で回す。

3. CLAUDE.md に TDD ルールを刻む

# Workflow
- For new features: write failing tests FIRST, never start with implementation
- Run tests after every change
- Refactor only when green

毎セッション TDD モードを再宣言せずに済む。

実装の流れ（実例）

``` ユーザー: "新しい /webhook/payment エンドポイントが要る。 まず失敗するテストを書いて。"

Claude: describes test cases → writes test file → runs → 失敗確認

ユーザー: "OK、最小実装で通して"

Claude: writes minimal handler → runs tests → green 確認

ユーザー: "重複コードがあるからリファクタ"