---
generated_at: 2026-02-19 13:20:00
metrics:
  claims_total: 35
  claims_with_evidence: 32
  claims_without_evidence: 3
confidence_derived: 0.91
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.91**
  - 根拠あり：32 / 35、根拠なし：3
- 優先レビュー（高）
  1. **TTL設定の詳細**：キャッシュのTTL設定についてコード解析が不完全
  2. **依存関係ルールの厳密性**：レイヤー間依存ルールはドキュメントからの推測を含む
  3. **パフォーマンス計測の詳細**：Activity.fsの使用方法の詳細確認が必要

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

- E-01: `README.md` - プロジェクト概要、貢献ガイド
- E-02: `DEVGUIDE.md` - 開発ガイド、ビルド手順
- E-03: `docs/index.md` - コンパイラドキュメントインデックス
- E-04: `docs/overview.md` - コンパイラ概要、フェーズ説明
- E-05: `global.json` - .NET SDKバージョン設定
- E-06: `Directory.Build.props` - MSBuildプロパティ設定
- E-07: `src/Compiler/FSharp.Compiler.Service.fsproj` - プロジェクトファイル、コンパイル順序
- E-08: `src/Compiler/` ディレクトリ構造 - モジュール配置
- E-09: `src/FSharp.Core/` ディレクトリ構造 - コアライブラリ構成
- E-10: `src/FSharp.Build/` ディレクトリ構造 - MSBuildタスク構成
- E-11: `src/FSharp.Compiler.LanguageServer/` - Language Server構成
- E-12: `vsintegration/src/` ディレクトリ構造 - VS統合構成
- E-13: `tests/` ディレクトリ構造 - テスト構成
- E-14: `src/Compiler/Utilities/` - ユーティリティモジュール一覧
- E-15: `src/Compiler/Facilities/` - 基盤機能モジュール一覧
- E-16: `src/Compiler/AbstractIL/` - Abstract ILモジュール一覧
- E-17: `src/Compiler/SyntaxTree/` - 構文木モジュール一覧
- E-18: `src/Compiler/TypedTree/` - 型付き構文木モジュール一覧
- E-19: `src/Compiler/Checking/` - 型検査モジュール一覧
- E-20: `src/Compiler/Optimize/` - 最適化モジュール一覧
- E-21: `src/Compiler/CodeGen/` - コード生成モジュール一覧
- E-22: `src/Compiler/Driver/` - ドライバーモジュール一覧
- E-23: `src/Compiler/Service/` - サービスモジュール一覧
- E-24: `src/Compiler/Symbols/` - シンボルAPIモジュール一覧
- E-25: `src/Compiler/Interactive/` - F# Interactiveモジュール一覧

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | F#コンパイラはパイプライン・アーキテクチャを採用 | E-04 | ○ |
| C-02 | 主要フェーズは字句解析→構文解析→型検査→最適化→コード生成→IL出力 | E-04 | ○ |
| C-03 | FSharp.Compiler.Serviceがコア機能を提供 | E-01, E-04 | ○ |
| C-04 | fsc/fsiはFSharp.Compiler.Serviceを使用 | E-04, E-07 | ○ |
| C-05 | lex.fsl/pars.fsyによるFsLex/FsYacc使用 | E-04, E-07 | ○ |
| C-06 | SyntaxTree.fsがAST定義を含む | E-04, E-17 | ○ |
| C-07 | TypedTree.fsが型付き構文木を定義 | E-04, E-18 | ○ |
| C-08 | ConstraintSolver.fsが制約解決を担当 | E-04, E-19 | ○ |
| C-09 | IlxGen.fsがILコード生成を担当 | E-04, E-21 | ○ |
| C-10 | ilread.fs/ilwrite.fsがIL読み書きを担当 | E-04, E-16 | ○ |
| C-11 | Utilitiesはコンパイラ非依存 | E-03, E-14 | ○ |
| C-12 | Facilitiesはコンパイラ固有基盤 | E-03, E-15 | ○ |
| C-13 | BackgroundCompiler.fsがバックグラウンドコンパイルを担当 | E-23 | ○ |
| C-14 | IncrementalBuild.fsがインクリメンタルビルドを担当 | E-04, E-23 | ○ |
| C-15 | .NET SDK 10.0.101を使用 | E-05 | ○ |
| C-16 | Microsoft.DotNet.Arcade.Sdk 10.0.0-beta.26110.1を使用 | E-05 | ○ |
| C-17 | FSharp.Coreが別プロジェクトとして存在 | E-09 | ○ |
| C-18 | FSharp.BuildがMSBuildタスクを提供 | E-04, E-10 | ○ |
| C-19 | Language Serverが存在 | E-11 | ○ |
| C-20 | VS統合がvsintegration/に存在 | E-12 | ○ |
| C-21 | DiagnosticsLogger.fsが診断ログを担当 | E-15 | ○ |
| C-22 | LanguageFeatures.fsが言語機能を管理 | E-15 | ○ |
| C-23 | Caches.fs/LruCache.fs/AsyncMemoize.fsがキャッシュを提供 | E-14, E-15 | ○ |
| C-24 | Activity.fsがパフォーマンス計測を提供 | E-14 | ○ |
| C-25 | コンパイラはブートストラップされている | E-02, E-04 | ○ |
| C-26 | FSharp.DependencyManager.Nugetが依存関係管理を担当 | E-07 | ○ |
| C-27 | CheckDeclarations.fsが宣言の型検査を担当 | E-04, E-19 | ○ |
| C-28 | NameResolution.fsが名前解決を担当 | E-04, E-19 | ○ |
| C-29 | Optimizer.fsが最適化を担当 | E-04, E-20 | ○ |
| C-30 | LowerStateMachines.fsがステートマシン変換を担当 | E-20 | ○ |
| C-31 | EraseClosures.fs/EraseUnions.fsがIL書き換えを担当 | E-04, E-21 | ○ |
| C-32 | ilreflect.fsがReflection Emitを担当 | E-04, E-16 | ○ |
| C-33 | キャッシュのTTLはセッション依存/容量ベース | **根拠なし** | △ |
| C-34 | レイヤー間依存は上位から下位への一方向のみ | E-03, E-07（部分的） | △ |
| C-35 | Activity.fsはSystem.Diagnostics.Activityを使用 | **根拠不十分** | △ |

## 4) 不足情報（Unknown / Missing）
- **キャッシュTTL設定の詳細**
  - Caches.fs、LruCache.fs、AsyncMemoize.fsの実装詳細を確認する必要がある
  - 候補：Caches.fs内のコメント / LruCacheの容量設定箇所

- **レイヤー間依存ルールの厳密な定義**
  - 公式ドキュメントに明示的なルールは記載されていない
  - fsprojファイルのコンパイル順序から推測
  - 候補：コントリビューションガイドライン / コードレビューガイド

- **Activity.fsの詳細実装**
  - System.Diagnostics.Activityの使用は推測
  - 候補：Activity.fsの直接確認

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 全体構成、主要モジュールの配置と責務
- **0: 低リスク** - コンパイルフェーズの順序と各フェーズの担当モジュール
- **0: 低リスク** - 外部依存関係（.NET SDK、NuGet等）
- **1: 中リスク** - キャッシュ戦略の詳細（TTL、容量等）
- **1: 中リスク** - レイヤー間依存ルールの厳密性
- **0: 低リスク** - ブートストラップ手順

## 6) レビュアーチェックリスト（最小）
- [ ] docs/overview.mdの内容とアーキテクチャ設計書の整合性を確認
- [ ] FSharp.Compiler.Service.fsprojのコンパイル順序がレイヤー構成と一致することを確認
- [ ] キャッシュ関連モジュール（Caches.fs、LruCache.fs、AsyncMemoize.fs）の実装詳細を確認
- [ ] Activity.fsの実装がSystem.Diagnostics.Activityを使用していることを確認
- [ ] レイヤー間依存ルールが実際のコード参照と一致することをサンプリング確認
- [ ] 外部依存パッケージのバージョンがglobal.json/Directory.Build.propsと一致することを確認
