---
generated_at: 2026-02-18 12:30:00
metrics:
  claims_total: 45
  claims_with_evidence: 42
  claims_without_evidence: 3
confidence_derived: 0.93
---

# 根拠レポート：コードリーディングガイドライン

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：42 / 45、根拠なし：3
- 優先レビュー（高）
  1. **C-43**: LangGraphワークフローの詳細動作（実際の実行ログ未確認）
  2. **C-44**: 全パッケージ間の依存関係図（動的に変化する可能性）
  3. **C-45**: デバッグ手法の網羅性（開発者個人の経験に依存する部分）

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

- E-01: `package.json` (ルート)
- E-02: `frontend/apps/app/package.json`
- E-03: `frontend/packages/erd-core/package.json`
- E-04: `frontend/packages/ui/package.json`
- E-05: `frontend/packages/schema/package.json`
- E-06: `frontend/packages/cli/package.json`
- E-07: `frontend/internal-packages/agent/package.json`
- E-08: `frontend/internal-packages/db/package.json`
- E-09: `turbo.json`
- E-10: `biome.jsonc`
- E-11: `frontend/internal-packages/configs/biome.jsonc`
- E-12: `CLAUDE.md`
- E-13: `CONTRIBUTING.md`
- E-14: `README.md`
- E-15: `frontend/apps/app/app/page.tsx`
- E-16: `frontend/apps/app/app/layout.tsx`
- E-17: `frontend/packages/ui/src/components/Button/Button.tsx`
- E-18: `frontend/packages/ui/src/index.ts`
- E-19: `frontend/packages/erd-core/src/index.ts`
- E-20: `frontend/internal-packages/agent/src/index.ts`
- E-21: `frontend/internal-packages/agent/src/createGraph.ts`
- E-22: `frontend/apps/app/features/public-share/actions.ts`
- E-23: `frontend/apps/app/hooks/usePublicShareServerAction.ts`
- E-24: `frontend/apps/app/components/SessionDetailPage/SessionDetailPage.tsx`
- E-25: `docs/langgraph/README.md`
- E-26: `docs/migrationOpsContext.md`
- E-27: `docs/test-principles.md`

## 3) Claims と根拠の対応（レビューの主戦場）

### 言語・フレームワーク

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | TypeScriptを主要言語として使用 | E-01, E-02, E-03, E-04 | ○ |
| C-02 | React 19を使用 | E-02 (依存関係に"react": "19.1.1") | ○ |
| C-03 | Next.js 15を使用 | E-02 (依存関係に"next": "15.4.8") | ○ |
| C-04 | pnpm workspacesでモノレポ管理 | E-01 (packageManager: "pnpm@10.18.3") | ○ |
| C-05 | Turborepoでビルド管理 | E-01, E-09 | ○ |
| C-06 | Biomeでリント/フォーマット | E-10, E-11 | ○ |

### アーキテクチャ

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-07 | apps/appがメインWebアプリケーション | E-02, E-12 | ○ |
| C-08 | packages/uiが共有UIコンポーネント | E-04, E-18 | ○ |
| C-09 | packages/erd-coreがERD可視化コア | E-03, E-19 | ○ |
| C-10 | packages/schemaがスキーマパーサー | E-05 | ○ |
| C-11 | packages/cliがコマンドラインツール | E-06 | ○ |
| C-12 | internal-packages/agentがAIエージェント | E-07, E-20 | ○ |
| C-13 | internal-packages/dbがSupabase連携 | E-08 | ○ |

### コードパターン

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-14 | 名前付きエクスポートを使用 | E-18, E-19, E-20 | ○ |
| C-15 | CSS Modulesでスタイリング | E-04 (typed-css-modules), E-17 | ○ |
| C-16 | ts-patternでパターンマッチング | E-17 | ○ |
| C-17 | valibotでバリデーション | E-02, E-07 | ○ |
| C-18 | neverthrowでResult型エラーハンドリング | E-02, E-07, E-23 | ○ |
| C-19 | useプレフィックスでカスタムフック | E-23 | ○ |
| C-20 | handleプレフィックスでイベントハンドラ | E-12 | ○ |

### Next.js固有

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-21 | App Routerを使用 | E-15, E-16 | ○ |
| C-22 | Server Componentsでデータフェッチ | E-24 | ○ |
| C-23 | Server Actionsでミューテーション | E-22 | ○ |
| C-24 | 'use server'ディレクティブ使用 | E-22 | ○ |

### AIエージェント

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-25 | LangGraphでワークフロー実装 | E-21, E-25 | ○ |
| C-26 | StateGraphで状態管理 | E-21 | ○ |
| C-27 | 複数エージェント（Lead, PM, DB, QA）が連携 | E-21 | ○ |
| C-28 | サブグラフパターン使用 | E-21 | ○ |

### データベース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-29 | Supabaseを使用 | E-08 (@supabase/supabase-js) | ○ |
| C-30 | マイグレーションファイルで管理 | E-26 | ○ |
| C-31 | Supabase Branchingでデプロイ | E-26 | ○ |

### UIコンポーネント

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-32 | Buttonコンポーネントのvariant/sizeプロップ | E-17 | ○ |
| C-33 | clsxでクラス名結合 | E-17 | ○ |
| C-34 | Radix UIコンポーネント使用 | E-04 | ○ |

### 開発環境

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-35 | localhost:3001でapp起動 | E-13 | ○ |
| C-36 | localhost:5173でcli起動 | E-13 | ○ |
| C-37 | localhost:3002でdocs起動 | E-13 | ○ |
| C-38 | localhost:6006でstorybook起動 | E-13 | ○ |

### ドキュメント

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-39 | CLAUDE.mdに開発ガイドライン記載 | E-12 | ○ |
| C-40 | CONTRIBUTING.mdにセットアップ手順記載 | E-13 | ○ |
| C-41 | docs/langgraphにLangGraphガイド | E-25 | ○ |
| C-42 | docs/test-principles.mdにテスト方針 | E-27 | ○ |

### 根拠不足の項目

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-43 | LangGraphワークフローの実行時動作詳細 | **根拠なし** | △ |
| C-44 | 全パッケージ間の完全な依存関係図 | **根拠なし** | △ |
| C-45 | デバッグ手法の網羅性 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-43**: LangGraphワークフローの実行時動作
  - 理由: 実際の実行ログやテスト結果を確認していない
  - 候補: 統合テストの実行結果 / LangSmithのトレースログ / 開発者インタビュー

- **C-44**: パッケージ間依存関係の完全図
  - 理由: 動的に追加されるパッケージや条件付き依存関係を網羅していない可能性
  - 候補: pnpm-lock.yaml / Turborepoのタスクグラフ

- **C-45**: デバッグ手法
  - 理由: 開発者個人の経験やプロジェクト固有のデバッグツールが存在する可能性
  - 候補: 開発チームへのヒアリング / 社内Wikiドキュメント

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: 言語・フレームワーク情報、ファイル構造
- **0 (低リスク)**: 命名規則、コードパターン
- **1 (中リスク)**: LangGraphワークフローの動作説明（実行確認推奨）
- **0 (低リスク)**: 開発環境セットアップ手順

## 6) レビュアーチェックリスト（最小）
- [ ] 言語・フレームワークのバージョンが最新のpackage.jsonと一致しているか確認
- [ ] ディレクトリ構造図が実際のファイルシステムと一致しているか確認
- [ ] コード例のファイルパスと行番号が実在するか確認
- [ ] LangGraphワークフローの説明が実際の動作と一致するか開発者に確認
- [ ] 命名規則がCLAUDE.mdの記載と整合しているか確認
- [ ] 参考資料のURLが有効か確認
