tdd — Red-Green-Refactor(レッド・グリーン・リファクタ)
鉄則
失敗するテストなしにプロダクションコードを書くな。
テストより先にコードを書いたか? 削除しろ。最初からやり直せ。 例外はない——「参考」として残すな、テストを書くときに「調整」するな、見るな。テストから新しく実装しろ。
ルールの文言に違反することは、その精神に反することだ。
トリガー
以下の場合に発動:「TDD this」・「red-green-refactor」・「test-first」・新機能・バグ修正・リファクタリング・振る舞い変更。AFKモードのタスクで、テスト基盤が存在する場合は、[[afk-vs-hitl-tasks]]に従い、自動で発動する。
例外(事前確認必須): 使い捨てプロトタイプ、生成コード、設定ファイル。
「今回だけTDDを省略しよう」と考えているか? やめろ。それは自己正当化だ——迷っているなら references/rationalizations.md を見よ。
前提条件
テストループは60秒未満([[feedback-loops-are-the-ceiling]] 参照)。ループが遅いなら、まずループを修正しろ。遅いテストを避けるためにTDDをスキップするな。
CONTEXT.md とエリアのADRを先に読め——テスト名とインターフェースの語彙はプロジェクトのドメイン言語に一致させること。(ドメイン語彙のステップは Matt Pocock 2026-07-08 による。)
Seam(シーム)——事前に合意せよ
Seam とは、内部に立ち入らずに振る舞いを観察できる公開境界のこと。テストはSeamに置かれ、内部に対しては決して書かない。コードは変わるが、Seamに固定されたテストは生き残る。
テストを書く前に、ユーザーとSeamを確認しろ。 確認されていないSeamに対してテストを書くな。作業はクリティカルパスと複雑なロジックに集中し、すべてのエッジケースを追わなくてよい。次のように尋ねよ:「どのSeamをテストすべきですか?」(Seamのフレーミングは Matt Pocock 2026-07-08 による。)
サイクル——厳密な順序
| ステップ | アクション | 確認事項 |
|---|---|---|
| RED(レッド) | 合意したSeamに対して、1つの失敗するテスト。最小の観測可能な振る舞い。モックはやむを得ない場合を除き使わず、実際のコードを使う。明確な名前。「and」で複数条件をつなげない。 | テストが期待されたエラーでFAILすること。すぐにパスした? 既存の振る舞いをテストしている——テストを修正せよ。エラーが出た? エラーを修正し、正しく失敗するまで再実行。 |
| GREEN(グリーン) | テストを通すための最小限のコード。YAGNIの選択肢はなし。未テストのエラーハンドリングは禁止。 | テストがPASSすること。他のテストもすべてパスのまま。出力は整っている。失敗する? コードを修正し、テストは決していじるな。 |
| REFACTOR(リファクタ) | 深いモジュールに抽出せよ([[deep-modules-over-shallow]] 参照)。明確にするために名前を変更せよ。リファクタで振る舞いを追加するな。 | グリーンのまま。 |
| LOOP(ループ) | 次の失敗するテストへ。垂直スライス——1テスト→1実装→繰り返し。それぞれ、前のサイクルが教えたことに反応するトレーサーブレット。REDに戻る。 | — |
アンチパターン——ロック済み
- 実装結合——内部の協調オブジェクトをモックし、プライベートメソッドをテストし、サイドチャネル(DBクエリ vs インターフェース)を通じてアサートする。兆候:振る舞いが変わっていないのにリファクタで壊れる。
- トートロジカル——アサーションがコードと同じ方法で期待値を再計算する(
expect(add(a,b)).toBe(a+b)、手作業で導出したスナップショット、定数がそれ自身と等しい)。定義上パスする。期待値は独立したソースから:既知の正しいリテラル、実例、仕様。(トートロジカルのフレーミングは Matt Pocock 2026-07-08 による。) - 水平スライシング——すべてのテストを先に書き、その後すべての実装を書く。想定された振る舞いを検証し、テストは実際の変更に対して鈍感になる。垂直スライスのみで作業せよ。(水平 vs 垂直のフレーミングは Matt Pocock 2026-07-08 による。)
アンチチート——ロック済み
- プロダクションコードを書く前に、失敗するテストの出力を確認しなければならない。
- 最初のテストがパスする前に、複数のテストを書いてはならない。
- リファクタをスキップしてはならない。
- 事後的に、テストを実装に合わせて書き換えてはならない。
コードの後で書かれたテスト = コードの形をしていて、仕様の形をしていない。目的に反する。
各サイクルの出力形式
SEAM: <テスト対象の公開インターフェース>
RED: <テスト名> → <期待される失敗メッセージ>
GREEN: <変更されたファイル、LOCの差分>
REFACTOR: <抽出・リネームされたもの>
相互参照
- feedback-loops-are-the-ceiling
- deep-modules-over-shallow
- afk-vs-hitl-tasks
references/rationalizations.md——「TDDは独断的だ」という決まり文句に対する反論- 出典:Kent Beck 1999 · obra/superpowers test-driven-development 2026-07-04 マージ · Matt Pocock 2026-07-04(スキルチェックリスト)+ 2026-07-08(Seam、トートロジカル、垂直スライシング、CONTEXT.md)