---
generated_at: 2026-02-18 10:30:00
metrics:
  claims_total: 42
  claims_with_evidence: 38
  claims_without_evidence: 4
confidence_derived: 0.90
---

# 根拠レポート：アーキテクチャ設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.90**
  - 根拠あり：38 / 42、根拠なし：4
- 優先レビュー（高）
  1. **PostgreSQLバージョン「15+」**：明示的なバージョン指定なし
  2. **トランザクション分離レベル「READ COMMITTED」**：推測ベース
  3. **キャッシュTTL設定の詳細**：コード内の定義確認が必要
  4. **12-Factor Agents適用**：ドキュメント参照だが完全な適用確認は困難

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

- E-01: `/Users/shiori.matsubara/Desktop/liam-main/package.json` - ルートpackage.json
- E-02: `/Users/shiori.matsubara/Desktop/liam-main/turbo.json` - Turborepo設定
- E-03: `/Users/shiori.matsubara/Desktop/liam-main/pnpm-workspace.yaml` - pnpm workspace設定
- E-04: `/Users/shiori.matsubara/Desktop/liam-main/frontend/apps/app/package.json` - メインアプリpackage.json
- E-05: `/Users/shiori.matsubara/Desktop/liam-main/frontend/apps/app/next.config.ts` - Next.js設定
- E-06: `/Users/shiori.matsubara/Desktop/liam-main/frontend/apps/app/middleware.ts` - 認証ミドルウェア
- E-07: `/Users/shiori.matsubara/Desktop/liam-main/frontend/apps/docs/package.json` - ドキュメントサイトpackage.json
- E-08: `/Users/shiori.matsubara/Desktop/liam-main/frontend/packages/erd-core/package.json` - ERDコアpackage.json
- E-09: `/Users/shiori.matsubara/Desktop/liam-main/frontend/packages/schema/package.json` - スキーマパーサーpackage.json
- E-10: `/Users/shiori.matsubara/Desktop/liam-main/frontend/packages/ui/package.json` - UIライブラリpackage.json
- E-11: `/Users/shiori.matsubara/Desktop/liam-main/frontend/packages/cli/package.json` - CLIpackage.json
- E-12: `/Users/shiori.matsubara/Desktop/liam-main/frontend/internal-packages/agent/package.json` - AIエージェントpackage.json
- E-13: `/Users/shiori.matsubara/Desktop/liam-main/frontend/internal-packages/agent/src/createGraph.ts` - LangGraphワークフロー定義
- E-14: `/Users/shiori.matsubara/Desktop/liam-main/frontend/internal-packages/db/package.json` - DBパッケージpackage.json
- E-15: `/Users/shiori.matsubara/Desktop/liam-main/frontend/internal-packages/db/src/index.ts` - DB層エクスポート
- E-16: `/Users/shiori.matsubara/Desktop/liam-main/frontend/internal-packages/mcp-server/package.json` - MCP Serverpackage.json
- E-17: `/Users/shiori.matsubara/Desktop/liam-main/CLAUDE.md` - プロジェクトガイドライン
- E-18: `/Users/shiori.matsubara/Desktop/liam-main/docs/langgraph/README.md` - LangGraphガイド
- E-19: `/Users/shiori.matsubara/Desktop/liam-main/docs/migrationOpsContext.md` - マイグレーション運用コンテキスト

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

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | モノレポ構成を採用 | E-01, E-02, E-03 | ○ |
| C-02 | Turborepoによるモノレポ管理 | E-02 | ○ |
| C-03 | pnpm workspacesによるパッケージ管理 | E-03 | ○ |
| C-04 | Next.js 15使用 | E-04 (`"next": "15.4.8"`) | ○ |
| C-05 | React 19使用 | E-04 (`"react": "19.1.1"`) | ○ |
| C-06 | Supabaseをデータベースとして使用 | E-14, E-15 | ○ |
| C-07 | Supabase Authによる認証 | E-06, E-15 | ○ |
| C-08 | GitHub OAuth連携 | E-06 (callback route存在) | ○ |
| C-09 | LangGraph使用 | E-12 (`"@langchain/langgraph": "0.4.9"`) | ○ |
| C-10 | LangChain使用 | E-12 (`"@langchain/core": "0.3.78"`) | ○ |
| C-11 | Sentry統合 | E-04 (`"@sentry/nextjs": "9"`), E-05 | ○ |
| C-12 | Vercelデプロイ | E-01 (`"vercel": "41.7.8"`), E-05 | ○ |
| C-13 | @liam-hq/appがメインアプリケーション | E-04 | ○ |
| C-14 | @liam-hq/docsがドキュメントサイト | E-07 | ○ |
| C-15 | @liam-hq/cliがCLIツール | E-11 | ○ |
| C-16 | @liam-hq/erd-coreがERD可視化コア | E-08 | ○ |
| C-17 | @liam-hq/schemaがスキーマパーサー | E-09 | ○ |
| C-18 | @liam-hq/uiが共通UIコンポーネント | E-10 | ○ |
| C-19 | @liam-hq/agentがAIエージェントシステム | E-12, E-13 | ○ |
| C-20 | @liam-hq/dbがデータベースユーティリティ | E-14, E-15 | ○ |
| C-21 | @liam-hq/mcp-serverがMCP Server実装 | E-16 | ○ |
| C-22 | @xyflow/react使用（ERD表示） | E-08 (`"@xyflow/react": "12.8.6"`) | ○ |
| C-23 | Valibot使用（バリデーション） | E-04, E-08, E-12 | ○ |
| C-24 | neverthrow使用（エラーハンドリング） | E-04, E-08, E-14 | ○ |
| C-25 | CSS Modules使用 | E-17 (CLAUDE.md記載) | ○ |
| C-26 | fumadocs使用（ドキュメント） | E-07 (`"fumadocs-core": "15.6.1"`) | ○ |
| C-27 | PGlite使用 | E-04 (`"@electric-sql/pglite": "0.3.12"`) | ○ |
| C-28 | LeadAgent, PMAgent, DBAgent, QAAgent構成 | E-13 | ○ |
| C-29 | Supabase Realtime使用 | E-19 (realtime migration files exist) | ○ |
| C-30 | Row Level Security適用 | E-19 (RLS policy migrations) | ○ |
| C-31 | OpenAI API連携 | E-12 (`"@langchain/openai": "0.6.9"`) | ○ |
| C-32 | TypeScript使用 | E-01, E-04 (`"typescript": "5.9.3"`) | ○ |
| C-33 | Biome使用（linting/formatting） | E-04 (`"@biomejs/biome": "2.2.6"`) | ○ |
| C-34 | App Router使用 | E-05 (next.config.ts構造), E-17 | ○ |
| C-35 | Server Actions許可設定 | E-05 (`serverActions.allowedOrigins`) | ○ |
| C-36 | Prisma internals使用（スキーマ解析） | E-09 (`"@prisma/internals": "6.8.2"`) | ○ |
| C-37 | commander使用（CLI） | E-11 (`"commander": "13.1.0"`) | ○ |
| C-38 | Supabase Branching使用 | E-19 | ○ |
| C-39 | PostgreSQLバージョン15+ | **根拠なし** | △ |
| C-40 | トランザクション分離レベルREAD COMMITTED | **根拠なし** | △ |
| C-41 | キャッシュTTL設定詳細 | E-05 (部分的), **完全な確認なし** | △ |
| C-42 | 12-Factor Agents完全適用 | E-18 (参照のみ) | △ |

## 4) 不足情報（Unknown / Missing）

- **PostgreSQLバージョン明示**: Supabaseのドキュメントまたは設定ファイルで確認が必要
  - 候補：Supabase Dashboard / supabase/config.toml / Supabase公式ドキュメント
- **トランザクション分離レベル**: PostgreSQLデフォルト値を推測で記載。明示的な設定確認が必要
  - 候補：Supabase設定 / アプリケーションコード内の明示的設定
- **キャッシュTTL詳細設定**: next.config.tsのheaders設定は確認済みだが、他のキャッシュ設定の完全な確認が必要
  - 候補：Vercel設定 / その他API routeのキャッシュ設定
- **12-Factor Agents完全適用確認**: ガイドラインとしての参照は確認済みだが、全12ファクターの適用状況は要確認
  - 候補：実装コードの詳細レビュー

## 5) リスクフラグ（レビュー観点）

| フラグ | リスクレベル | 説明 |
|---|---|---|
| バージョン情報 | 0 (低) | PostgreSQLバージョンは一般的なSupabase構成を仮定 |
| トランザクション設定 | 0 (低) | PostgreSQLデフォルト値を使用と推測、重大な影響なし |
| キャッシュ設定 | 1 (中) | パフォーマンスに影響する可能性、本番環境で要確認 |
| AIエージェント設計 | 0 (低) | コードから構造を明確に確認済み |

## 6) レビュアーチェックリスト（最小）

- [ ] PostgreSQLバージョンがSupabase環境と一致しているか確認
- [ ] トランザクション分離レベルが要件を満たしているか確認
- [ ] 本番環境のキャッシュ設定が適切か確認
- [ ] AIエージェントワークフローの図がcreateGraph.tsの実装と一致しているか確認
- [ ] パッケージ依存関係図が最新のpackage.json群と一致しているか確認
- [ ] セキュリティ関連の設定（RLS、認証）が網羅されているか確認
