---

name: tdd-development description: TDD（テスト駆動開発）のRed-Green-Refactorサイクルでコードを「実装」する。「エンティティ」「サービス」「API」「機能」の実装時に使用。「テスト駆動」「TDD」で品質を担保する。

TDD開発ワークフロー

基本サイクル: Red-Green-Refactor

実装作業では以下のサイクルを繰り返す：

1. Red: 失敗するテストを先に書く
2. Green: テストを通す最小限のコードを書く
3. Refactor: コードを整理する（テストは通ったまま）

ワークフロー手順

Step 1: テスト作成（Red）

1. 実装したい機能・振る舞いをテストとして記述
2. テストを実行し、失敗することを確認
3. 失敗理由が「未実装」であることを確認

Step 2: 最小実装（Green）

1. テストを通すための最小限のコードを書く
2. 過度な設計・最適化は行わない
3. テストを実行し、成功することを確認

Step 3: リファクタリング（Refactor）

1. コードの重複を除去
2. 命名・構造を改善
3. テストを実行し、引き続き成功することを確認

実装の粒度

• 1サイクルは小さく保つ（5-15分程度で完了する単位）
• 機能を細かく分割し、段階的に実装
• 複雑な機能は複数サイクルで構築

テスト実行タイミング

• Red: テスト作成後に必ず実行（失敗確認）
• Green: 実装後に必ず実行（成功確認）
• Refactor: 変更のたびに実行（回帰確認）

このプロジェクトでの適用

• ユニットテスト: *.spec.tsファイル
• E2Eテスト: test/ディレクトリ
• テスト実行: npm run test:task（ユニット）、npm run test:task:e2e（E2E）
• 設計参照: docs/design/、テストシナリオ参照: docs/user-stories/