Automatic Implementation With Phase Finished Verification

Fail-Safe 原則: 判定に迷う場合は「不合格（要修正）」に倒す。品質を妥協しない。

⛔ 最重要ルール: Step 3.3（自己検証 grep チェック）は 各フェーズ完了時に必ず実行する。スキップして Step 4 のビルドに進むことは品質ゲートの無効化と同義であり禁止する。orchest-code-review エージェントによる包括的コードレビューは 全フェーズ完了後に 1 回だけ 実行する（各フェーズごとの実行は不要）。

前提条件

1. 指定されたサービス名に対応する以下のファイルが存在すること:
   • impl-plan/{service-name}-impl-plan.md — 実装計画プラン
   • design-docs/{service-name}-design.md — 詳細設計書
   • design-docs/spec.md — システム全体設計書
2. .github/instructions/ 配下のコーディング規約ファイルが存在すること
3. AGENTS.md が存在し、プロジェクト共通ルールが記載されていること
4. .NET 10 SDK がインストールされていること（dotnet --version で確認）

サービス名 → ファイル マッピング

実行手順（メインフロー）

Step 0: 初期化・前提確認

1. 指定されたサービス名から、上記マッピングテーブルに基づき対応ファイルを特定する
2. 以下のファイルの存在を確認:
   • impl-plan/{service}-impl-plan.md
   • design-docs/{service}-design.md（front-end の場合は front-end-need.md）
   • design-docs/spec.md
3. 実装計画プランを読み取り、全フェーズ一覧（Phase 1〜Phase N）を抽出する
4. 各フェーズの以下の情報を一覧化:
   • フェーズ番号と名称
   • 前提条件（依存フェーズ）
   • 実装タスク数
   • 完了チェックリスト項目数
5. SQL データベースに全フェーズを TODO として登録（進捗追跡用）:

INSERT INTO todos (id, title, description, status) VALUES
  ('{service}-phase-1', 'Phase 1: {phase_name}', '{phase_description}', 'pending'),
  ('{service}-phase-2', 'Phase 2: {phase_name}', '{phase_description}', 'pending'),
  ...;

6. .NET SDK バージョンを確認: dotnet --version
7. 既存プロジェクトの状態を確認: dotnet build（既存コードがある場合）

Step 1: フェーズ実装計画の読み取り

対象フェーズの実装計画プランから以下を抽出:

1. フェーズの目的・概要
2. 前提条件（依存する前フェーズの完了状態）
3. 実装タスク一覧（各タスクの詳細な実装内容）
   • 作成するファイル一覧
   • 実装するクラス・メソッド一覧
   • コード例・テンプレート（記載がある場合）
4. 完了チェックリスト（全チェック項目と基準）
5. 設計書参照セクション（§x.x の参照先）

Step 2: 設計書の該当セクション読み取り

1. 実装計画で参照されている設計書セクション（§x.x）を全て読み取る
2. 設計書に記載された以下の要件を抽出:
   • エンティティ定義（テーブル名、カラム名、型、制約）
   • API エンドポイント定義（HTTP メソッド、パス、リクエスト/レスポンス）
   • ビジネスロジック（バリデーション、計算式、状態遷移）
   • イベント定義（Kafka トピック、イベントペイロード）
   • セキュリティ要件（認証、認可、入力検証）
   • エラーハンドリング（エラーコード、例外クラス）

Step 3: フェーズ内全タスクの実装

実装計画のタスクを 上から順に 実装する。各タスクで以下のルールを遵守:

3.1 コーディング規約の遵守（AGENTS.md + .github/instructions/ 準拠）

3.2 ファイル作成順序

1. Models/（EF Core エンティティ）
2. DTOs/Requests/ と DTOs/Responses/（リクエスト/レスポンス DTO）
3. Infrastructure/Persistence/AppDbContext.cs（DbContext）
4. Repositories/Interfaces/ → Repositories/（インターフェース → 実装）
5. Services/Interfaces/ → Services/（インターフェース → 実装）
6. Endpoints/（Minimal API エンドポイント）
7. Configurations/（設定クラス）
8. Program.cs（DI 登録、ミドルウェア）
9. appsettings*.json（設定ファイル）

3.3 実装中の自己検証【必須 — スキップ厳禁】

⛔ MANDATORY GATE: Step 3 の全タスク実装完了後、次の全コマンドをターミナルで実行し、出力結果を確認すること。1 つでもスキップした場合、以降のステップは無効とする。

全コマンドを順にターミナルで実行すること（推測で PASS としない）:

# [3.3-CHECK-1] TODO/FIXME/HACK/NotImplementedException 残存チェック
grep -rn "TODO\|FIXME\|HACK\|UNDONE\|NotImplementedException" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-1: PASS (0 hits)"

# [3.3-CHECK-2] Console.WriteLine 残存チェック
grep -rn "Console\.Write" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-2: PASS (0 hits)"

# [3.3-CHECK-3] .Result / .Wait() デッドロックパターンチェック
grep -rn "\.Result\b\|\.Wait()" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-3: PASS (0 hits)"

# [3.3-CHECK-4] 秘密情報ハードコードチェック
grep -rn 'Password\s*=\s*"\|"sk-\|connectionString.*Password' --include="*.cs" --include="*.json" {ServiceDirectory}/ || echo "CHECK-4: PASS (0 hits)"

# [3.3-CHECK-5] DateTime.Now チェック（DateTime.UtcNow を使用すべき）
grep -rn "DateTime\.Now[^U]" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-5: PASS (0 hits)"

# [3.3-CHECK-6] プロパティインジェクション [Inject] チェック
grep -rn "\[Inject\]" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-6: PASS (0 hits)"

# [3.3-CHECK-7] FromSqlRaw 文字列結合チェック
grep -rn "FromSqlRaw.*+" --include="*.cs" {ServiceDirectory}/ || echo "CHECK-7: PASS (0 hits)"

# [3.3-CHECK-8] ダミー値チェック（テストプロジェクト除外）
grep -rn '"dummy"\|"placeholder"\|"xxx"' --include="*.cs" {ServiceDirectory}/ | grep -v ".Tests/" || echo "CHECK-8: PASS (0 hits)"

判定ルール:

• 全 8 チェックが PASS (0 hits) → Step 4（ビルド確認）に進行
• 1 件でも検出あり → 即座に該当箇所を修正し、修正後に再度全チェックを実行
• 検出がある状態で Step 4 に進んではならない

Step 4: ビルド確認

前提: Step 3.3 の全 8 チェックが PASS (0 hits) であること。

cd {ServiceDirectory}
dotnet build --no-restore 2>&1

• ビルドエラーが 0 件であること
• 警告（TreatWarningsAsErrors が有効な場合）が 0 件であること
• ビルド失敗時は即座にエラーを修正し、再ビルド（最大 5 回）

Step 5: 完了チェックリスト検証

実装計画の「Phase N 完了チェックリスト」に記載された 全項目 を検証する。

5.1 チェック項目の分類と検証方法

5.2 共通必須チェック（全フェーズで実行）

以下の 品質チェックパターン を全フェーズで実行:

# 1. TODO/FIXME/HACK コメント残存チェック
grep -rn "TODO\|FIXME\|HACK\|UNDONE\|XXX" --include="*.cs" {ServiceDirectory}/

# 2. NotImplementedException 残存チェック
grep -rn "NotImplementedException" --include="*.cs" {ServiceDirectory}/

# 3. Console.WriteLine 残存チェック
grep -rn "Console\.Write" --include="*.cs" {ServiceDirectory}/

# 4. 秘密情報ハードコードチェック
grep -rn "Password\s*=\s*\"" --include="*.cs" {ServiceDirectory}/

# 5. .Result / .Wait() チェック
grep -rn "\.\(Result\|Wait\)()" --include="*.cs" {ServiceDirectory}/

# 6. プロパティインジェクションチェック
grep -rn "\[Inject\]" --include="*.cs" {ServiceDirectory}/

# 7. FromSqlRaw 文字列結合チェック
grep -rn "FromSqlRaw.*+" --include="*.cs" {ServiceDirectory}/

# 8. 空メソッドボディチェック
grep -rn "{ }" --include="*.cs" {ServiceDirectory}/

# 9. ダミー値チェック
grep -rn "\"dummy\"\|\"test\"\|\"xxx\"\|\"placeholder\"" --include="*.cs" {ServiceDirectory}/
# （テストプロジェクト配下は除外）

# 10. DateTime.Now チェック（DateTime.UtcNow を使用すべき）
grep -rn "DateTime\.Now[^U]" --include="*.cs" {ServiceDirectory}/

5.3 検証結果の記録

各チェック項目を以下の判定で記録:

5.4 判定基準

Step 5.5: 不合格時の是正サイクル

不合格 → 是正 → 再検証 → 合格？
  ├── YES → Step 6 へ
  └── NO → 是正 → 再検証（最大 3 回まで）
       └── 3 回連続不合格 → ユーザーに報告して中断

1. 不合格項目の特定: FAIL / PARTIAL の項目を一覧化
2. 是正の実施: 各不合格項目を修正
3. 再ビルド: dotnet build で修正がビルドを壊していないか確認
4. 再検証: Step 5 を再実行
5. 3 回連続不合格の場合: ユーザーに状況を報告し、手動介入を求める

Step 6: 検証レポート生成・次フェーズへの進行

6.1 検証レポートの生成

# {ServiceName} Phase {N} 完了検証レポート

## 実施日時
{YYYY-MM-DD HH:MM (UTC)}

## 総合判定
{✅ 合格 / ⚠️ 条件付き合格 / ❌ 不合格}

## 1. 完了チェックリスト結果
| # | チェック項目 | 結果 | 備考 |
|---|------------|------|------|
| 1 | {item} | ✅/⚠️/❌ | {notes} |
...

## 2. 共通品質チェック結果
| # | チェック項目 | 検出数 | 結果 |
|---|------------|-------|------|
| 1 | TODO/FIXME/HACK 残存 | 0 | ✅ |
| 2 | NotImplementedException 残存 | 0 | ✅ |
| 3 | Console.WriteLine 残存 | 0 | ✅ |
...

## 3. 是正履歴（該当する場合）
| 試行 | 不合格項目 | 是正内容 | 結果 |
|------|----------|---------|------|

## 4. 次フェーズへの申し送り事項

6.2 SQL ステータス更新

UPDATE todos SET status = 'done' WHERE id = '{service}-phase-{N}';
UPDATE todos SET status = 'in_progress' WHERE id = '{service}-phase-{N+1}';

6.3 次フェーズへの進行

• 合格の場合: 自動的に Step 1 に戻り、次フェーズ（Phase N+1）を開始
• 最終フェーズの場合: 全フェーズ完了レポートを生成

全フェーズ完了時の最終検証

全フェーズが完了した場合、以下の最終検証を実施:

Final Step A: 最終統合チェック

# 1. 全体ビルド
dotnet build

# 2. 全テスト実行（テストプロジェクトがある場合）
dotnet test --no-build

# 3. 全体 grep チェック（全禁止パターン）
grep -rn "TODO\|FIXME\|HACK\|UNDONE\|XXX" --include="*.cs" {ServiceDirectory}/
grep -rn "NotImplementedException" --include="*.cs" {ServiceDirectory}/
grep -rn "Console\.Write" --include="*.cs" {ServiceDirectory}/
grep -rn "Password\s*=\s*\"" --include="*.cs" {ServiceDirectory}/
grep -rn "\.\(Result\|Wait\)()" --include="*.cs" {ServiceDirectory}/
grep -rn "\[Inject\]" --include="*.cs" {ServiceDirectory}/
grep -rn "FromSqlRaw.*+" --include="*.cs" {ServiceDirectory}/
grep -rn "DateTime\.Now[^U]" --include="*.cs" {ServiceDirectory}/

Final Step B: 最終コードレビュー【必須 — スキップ厳禁】

⛔ MANDATORY GATE: 全フェーズ完了後、必ず orchest-code-review エージェントを runSubagent ツールで 1 回呼び出すこと。各フェーズごとの実行は不要だが、全フェーズ完了後のこの最終レビューは 絶対にスキップしてはならない。レビュー結果（Critical/High/Medium/Low の件数）が得られない限り、最終レポートの生成に進めない。

orchest-code-review エージェント（14 の専門 Agent）による包括的コードレビューを実施する。 全フェーズの実装が完了した状態のコードに対して アーキテクチャ・DDD・セキュリティ・パフォーマンス・テスト品質 等の多角的な最終検証を行う。

B.1 レビュー実行【ツール呼び出し必須】

以下の runSubagent 呼び出しを必ず実行すること（省略・スキップ禁止）:

runSubagent を使用して orchest-code-review エージェントを呼び出す。

agentName: "orchest-code-review"