Y
仕様書から結合テストを自動生成・実行できる
by YasudaHispot
docs/design.md に記載された受入条件(Given/When/Then)から直接、結合テスト(IT)を作成できます。実装の内部ロジックではなく、仕様上の振る舞いだけを検証するため、テストが設計書と乖離しません。 仕様書を参照するだけで、実装コードを読まずにテストを導出できるため、テストが実装詳細に依存せず、リファクタリング(コードの整理)に強いテストになります。 テストにはspec参照コメント(Given/When/Then)を必ず記述するため、テスト失敗時に「仕様のバグなのか実装のバグなのか」を即座に判断できます。 仕様書ベースで開発進めるチーム・チームリード テストが実装詳細に依存して脆いと困っている組織 テストと設計書の同期を取りたい開発者 結合テストの作成効率を上げたい人 docs/design.md の受入条件セクションからGiven/When/Thenを抽出。テストは tests/integration/ に配置し、ファイル名は test__integration.py とします。各テストの冒頭に「IT: 、Source: docs/design.md」形式のトレーサビリティコメント記述が必須。正常系ではモック使用禁止(docs/mock-policy.md 参照)。テスト数は1機能あたり1〜3件の少数精鋭。実装コードの src/evaldataset/ 配下は参照禁止。uv run pytest tests/integration/ -v で実行後、テスト失敗時は「仕様に合致しているか」を確認し、合致していればテストは修正せず実装側のバグとして報告します。
テストドキュメント設計