building

name	building
description	BUILDINGフェーズを開始 - TDD実装サイクル
version	1.0.0
disable-model-invocation	true

BUILDINGフェーズ開始

あなたは今から [BUILDING] モードに入ります。

実行ステップ

1. フェーズ状態を更新

   • .claude/current-phase.md を BUILDING に更新する

2. 状態ファイルを確認

   • .claude/states/<feature>.json を読み込む
   • PLANNING の全サブフェーズ（requirements, design, tasks）が approved か確認
   • 未承認があれば警告し、PLANNING に戻ることを提案

3. 必須ドキュメントを読み込む

   • docs/internal/02_DEVELOPMENT_FLOW.md の Phase 2 を精読
   • docs/internal/03_QUALITY_STANDARDS.md を確認
   • 関連する docs/specs/ の仕様書を読み込む

4. 影響分析（Pre-Flight）

   • 変更対象ファイル/モジュールの依存関係を調査
   • 直接影響（import/require 元）と間接影響を特定
   • 公開 API/IF の変更有無を確認
   • 影響を受けるテストケースを特定
   • 変更を PG/SE/PM に分類し、PM級があれば承認を求める
   • 権限等級の詳細: .claude/rules/permission-levels.md

5. 状態ファイルを更新

   • phase を BUILDING に更新
   • current_task を実装対象タスクIDに更新

6. BUILDINGルールを適用

   • TDDサイクル厳守: Red → Green → Refactor
   • 仕様書とコードの同期は絶対
   • 1サイクル完了ごとにユーザーに報告

7. 作業の進め方

   • TDD実装には tdd-developer サブエージェントを推奨
   • 実装前に必ず docs/specs/ の対応仕様を確認
   • コード変更時は対応ドキュメントも同時更新（Atomic Commit）

前提条件チェック

BUILDING に入る前に以下を確認:

PLANNING 承認状態:
- requirements: [approved/未承認]
- design: [approved/未承認]
- tasks: [approved/未承認]

未承認がある場合:

⚠️ BUILDING に移行できません

以下のサブフェーズが未承認です:
- [未承認サブフェーズ]

PLANNING フェーズで承認を完了してください。

TDDサイクル（t-wada style）

Step 1: Spec & Task Update

• コードを書く前に docs/specs/ の更新案を提示

Step 2: Red (Test First)

• 失敗するテストを先に書く
• テストは「実行可能な仕様書」

Step 3: Green (Minimal Implementation)

• テストを通す最小限のコードを実装
• 美しさより速さを優先

Step 4: Refactor

• Green になってから設計を改善
• 重複排除、可読性向上

Step 5: Commit & Review

• ユーザーに報告
• 必要に応じて docs/artifacts/walkthrough-<feature>.md に検証結果をまとめる

TDD 内省パイプライン v2

BUILDING フェーズでの TDD サイクル中、テスト失敗→成功のパターンは PostToolUse hook によって .claude/tdd-patterns.log に自動記録される。 閾値（2回）に達したパターンは /retro Step 2.5 で審査し、承認されれば .claude/rules/auto-generated/ にルールとして昇格する。 詳細: .claude/rules/auto-generated/trust-model.md

禁止事項

• 仕様書なしでの実装開始
• テストなしでの本実装
• ドキュメント更新なしのコード変更
• PLANNING が未承認のまま実装を開始すること

フェーズ終了条件

以下を満たしたら AUDITING フェーズへ手動移行:

• 全テストがパス
• 仕様書とコードが同期している
• docs/artifacts/walkthrough-<feature>.md で検証完了（任意）
• 状態ファイルの current_task を null に、completed_tasks にタスクIDを追加

確認メッセージ

以下を表示してユーザーに確認:

[BUILDING] フェーズを開始しました。

PLANNING 承認状態:
- requirements: ✅ approved
- design: ✅ approved
- tasks: ✅ approved

適用ルール:
- TDDサイクル: Red → Green → Refactor
- ドキュメント同期: 必須
- 報告: 1サイクルごと
- 影響分析: 実装前に必須

読み込み済み:
- 02_DEVELOPMENT_FLOW.md (Phase 2)
- 03_QUALITY_STANDARDS.md

どのタスクから実装しますか？