---
generated_at: 2026-02-18 13:15:00
metrics:
  claims_total: 28
  claims_with_evidence: 26
  claims_without_evidence: 2
confidence_derived: 0.93
---

# 根拠レポート：21-QA Agent.md

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：26 / 28、根拠なし：2
- 優先レビュー（高）
  1. **テスト失敗時の再生成上限**：コード内で明示的な上限値が確認できない
  2. **pgTapテスト実行の詳細仕様**：runTestToolの実装詳細が未確認

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `frontend/internal-packages/agent/src/qa-agent/createQaAgentGraph.ts`
- E-02: `frontend/internal-packages/agent/src/qa-agent/shared/qaAgentAnnotation.ts`
- E-03: `frontend/internal-packages/agent/src/qa-agent/testcaseGeneration/index.ts`
- E-04: `frontend/internal-packages/agent/src/qa-agent/testcaseGeneration/generateTestcaseNode.ts`
- E-05: `frontend/internal-packages/agent/src/qa-agent/validateSchema/index.ts`
- E-06: `frontend/internal-packages/agent/src/qa-agent/nodes/analyzeTestFailuresNode.ts`
- E-07: `frontend/internal-packages/agent/src/qa-agent/routing/routeAfterAnalyzeFailures.ts`
- E-08: `frontend/internal-packages/agent/src/createGraph.ts`
- E-09: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv`
- E-10: `docs/code-to-docs/機能一覧/機能一覧.csv`

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | QA AgentはLangGraphフレームワークを使用している | E-01, E-03 | ○ |
| C-02 | QA Agentはテストケース生成を自動化する | E-04 | ○ |
| C-03 | QA AgentはMap-Reduceパターンで並列処理する | E-01 (34行目: continueToRequirements) | ○ |
| C-04 | QA Agentの状態にschemaData, analyzedRequirementsが含まれる | E-02 (15-27行目) | ○ |
| C-05 | テストケース生成はgpt-5-miniモデルを使用する | E-04 (20行目) | ○ |
| C-06 | LLM応答タイムアウトは120秒 | E-04 (69行目: timeout: 120000) | ○ |
| C-07 | tool_choice: 'required'でツール呼び出しを強制 | E-04 (27行目) | ○ |
| C-08 | validateSchemaノードでpgTapテスト呼び出しを準備 | E-05 (17-28行目: runTestTool呼び出し) | ○ |
| C-09 | analyzeTestFailuresNodeで失敗テストを抽出 | E-06 (4-25行目: extractFailedTests関数) | ○ |
| C-10 | 失敗分析後にrouteAfterAnalyzeFailuresでルーティング | E-01 (49行目), E-07 | ○ |
| C-11 | デザインセッション詳細画面（14番）が関連画面 | E-09 (49行目) | ○ |
| C-12 | QA Agentの機能説明が機能一覧と一致 | E-10 (22行目) | ○ |
| C-13 | testcaseGenerationサブグラフの構造が正しい | E-03 (12-31行目) | ○ |
| C-14 | applyGeneratedSqlsノードが存在する | E-01 (20行目) | ○ |
| C-15 | invokeRunTestToolノードが存在する | E-01 (25-27行目) | ○ |
| C-16 | resetFailedSqlTestsノードが存在する | E-01 (29行目) | ○ |
| C-17 | QA AgentはcreateGraph.tsから呼び出される | E-08 (44-52行目: callQaAgent) | ○ |
| C-18 | QA_AGENT_RECURSION_LIMITが使用される | E-08 (48行目) | ○ |
| C-19 | サブグラフでRETRY_POLICYが適用される | E-01 (22-27行目: retryPolicy) | ○ |
| C-20 | failureAnalysisにfailedSqlTestIdsが含まれる | E-06 (39-43行目) | ○ |
| C-21 | qaAgentAnnotationにnextフィールドが存在 | E-02 (36-39行目) | ○ |
| C-22 | テストケース数の計算式が正しい | E-05 (5-9行目: getTestcaseCount) | ○ |
| C-23 | generateTestcaseNodeでstreamLLMResponseを使用 | E-04 (84-87行目) | ○ |
| C-24 | スキーマをYAML形式に変換して処理 | E-04 (40-44行目: yamlSchemaDeparser) | ○ |
| C-25 | formatPreviousFailuresで過去の失敗を取得 | E-04 (46行目) | ○ |
| C-26 | reasoningモードでminimal effortを使用 | E-04 (21行目) | ○ |
| C-27 | テスト失敗時の再生成上限は最大3回 | **根拠なし** | △ |
| C-28 | runTestToolの具体的な実装詳細 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- テスト失敗時の再生成上限値（3回）に関する直接的なコード根拠
  - 候補：constants.ts / routeAfterAnalyzeFailures.ts内のロジック確認
- runTestToolの実装詳細（pgTap呼び出しの具体的な処理）
  - 候補：`frontend/internal-packages/agent/src/tools/runTestTool.ts`の詳細確認

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 大部分の主張がソースコードから直接確認可能
- 1: 中リスク - 再生成上限の仕様が明確でない可能性

## 6) レビュアーチェックリスト（最小）
- [ ] C-27: テスト失敗時の再生成上限値が実装と一致するか確認
- [ ] C-28: runTestToolの実装詳細を確認し、必要に応じて設計書を補完
- [ ] QA_AGENT_RECURSION_LIMITの具体的な値を確認
- [ ] プロンプトテンプレート（prompts.ts）の内容が設計書と整合しているか確認
