TDD実装フロー (Red -> Green -> Refactor)

参照元: implement-issues.md から分離されたTDD実装ガイド

概要

全てcontainer-use環境内で実行する。

0. テスト項目書の参照（推奨）

TDD開始前に、詳細設計フェーズで作成されたテスト項目書を参照する。

テスト項目書活用のメリット:

• 詳細設計フェーズで網羅性が検証済み
• 境界条件・エラーケースが明確
• TDDのRed→Greenがスムーズに

テスト項目書がない場合:

• 設計書から必要なテストケースを推論
• 基本的なハッピーパス + エラーケースを実装

🔴 Red: テスト実装

Test Log Compression (ログ圧縮)

Token最適化: テスト実行ログは膨大になりがち。成功ログはノイズ。
常に失敗したテストのみを出力するか、出力をフィルタリングする。

# npm (Jest) の場合: --silent または failureのみgrep
npm test -- --silent --testPathPattern='feature-name'
# または
npm test 2>&1 | grep -A 5 "FAIL"

# Cargo (Rust) の場合: --quiet
cargo test --quiet

# テスト実行 (失敗を確認)
container-use_environment_run_cmd(
    environment_id=env_id,
    environment_source="/path/to/repo",
    # 冗長な出力を抑制
    command="npm test -- --silent --testPathPattern='feature-name'"
)

🟢 Green: 最小実装

# ファイル編集
container-use_environment_file_write(
    environment_id=env_id,
    environment_source="/path/to/repo",
    target_file="src/feature.ts",
    contents="// implementation"
)

# テスト実行 (成功を確認)
container-use_environment_run_cmd(...)

🔵 Refactor: 整理

# Lint & 型チェック
container-use_environment_run_cmd(
    environment_id=env_id,
    environment_source="/path/to/repo",
    command="npm run lint -- --fix && npm run type-check"
)

DBマイグレーションのテスト (DB関連Issue)

# マイグレーション実行
container-use_environment_run_cmd(command="npx flyway migrate")

# ロールバックテスト
container-use_environment_run_cmd(command="npx flyway undo")

# 再マイグレーション
container-use_environment_run_cmd(command="npx flyway migrate")

次のステップ