---
generated_at: 2026-03-01 13:45: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. **ESMサポートの実験的機能**: ドキュメント不足、実装状況の確認が必要
  2. **V8カバレッジの詳細仕様**: 具体的な設定・制約の確認が必要
  3. **Watchman連携の詳細**: オプション設定の確認が必要

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

- E-01: `packages/jest/package.json` - メインエントリーポイントのパッケージ定義
- E-02: `packages/jest-cli/package.json` - CLIパッケージの依存関係
- E-03: `packages/jest-cli/src/run.ts` - CLIエントリーポイント実装
- E-04: `packages/jest-core/package.json` - コアパッケージの依存関係
- E-05: `packages/jest-core/src/index.ts` - コアエクスポート定義
- E-06: `packages/jest-core/src/runJest.ts` - テスト実行メインフロー
- E-07: `packages/jest-core/src/TestScheduler.ts` - テストスケジューラ実装
- E-08: `packages/jest-runner/package.json` - ランナーパッケージ依存関係
- E-09: `packages/jest-runner/src/index.ts` - ランナー実装
- E-10: `packages/jest-runtime/package.json` - ランタイムパッケージ依存関係
- E-11: `packages/jest-runtime/src/index.ts` - ランタイム実装
- E-12: `packages/jest-circus/package.json` - Circusテストランナー依存関係
- E-13: `packages/jest-circus/src/run.ts` - Circusテスト実行フロー
- E-14: `packages/jest-config/package.json` - 設定パッケージ依存関係
- E-15: `packages/jest-transform/package.json` - トランスフォームパッケージ依存関係
- E-16: `packages/jest-snapshot/package.json` - スナップショットパッケージ依存関係
- E-17: `packages/jest-mock/package.json` - モックパッケージ依存関係
- E-18: `packages/jest-worker/package.json` - ワーカーパッケージ依存関係
- E-19: `packages/jest-reporters/package.json` - レポーターパッケージ依存関係
- E-20: `packages/jest-haste-map/package.json` - ハッシュマップパッケージ依存関係
- E-21: `packages/jest-environment-node/package.json` - Node環境パッケージ依存関係
- E-22: `packages/expect/package.json` - Expectパッケージ依存関係
- E-23: `package.json` - モノレポルート設定
- E-24: `lerna.json` - Lerna設定
- E-25: `CLAUDE.md` / `.github/copilot-instructions.md` - プロジェクト指示書

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

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Jestは55以上のパッケージで構成されるモノレポ | E-23, E-24 | ○ |
| C-02 | Lerna-liteとYarn Workspacesによるモノレポ管理 | E-23, E-24 | ○ |
| C-03 | バージョン30.2.0 | E-01, E-23, E-24 | ○ |
| C-04 | jest → jest-cli → @jest/core の依存関係 | E-01, E-02, E-03 | ○ |
| C-05 | yargsによるCLI引数解析 | E-02, E-03 | ○ |
| C-06 | TestSchedulerがテスト実行を統括 | E-06, E-07 | ○ |
| C-07 | SearchSourceによるテストファイル発見 | E-06 | ○ |
| C-08 | jest-workerによる並列テスト実行 | E-08, E-09, E-18 | ○ |
| C-09 | jest-circusがデフォルトテストランナー | E-12, E-14 | ○ |
| C-10 | jest-jasmine2はレガシーランナー | E-08, E-14 | ○ |
| C-11 | jest-runtimeがモジュール解決を担当 | E-10, E-11 | ○ |
| C-12 | jest-mockによるモック機能提供 | E-10, E-17 | ○ |
| C-13 | @jest/transformによるコード変換 | E-10, E-15 | ○ |
| C-14 | babel-jestがデフォルトトランスフォーマー | E-14, E-15 | ○ |
| C-15 | jest-snapshotによるスナップショットテスト | E-10, E-16 | ○ |
| C-16 | expectがアサーションライブラリ | E-12, E-22 | ○ |
| C-17 | @jest/reportersがレポート出力を担当 | E-04, E-19 | ○ |
| C-18 | istanbul連携によるカバレッジ | E-19 | ○ |
| C-19 | jest-haste-mapによるファイルシステムキャッシュ | E-04, E-20 | ○ |
| C-20 | graceful-fsの使用強制 | E-25, E-04, E-10 | ○ |
| C-21 | Node.js ^18.14.0サポート | E-01, E-23 | ○ |
| C-22 | Emitteryによるイベント駆動通信 | E-08, E-09 | ○ |
| C-23 | pLimitによるコンカレンシー制御 | E-09, E-13 | ○ |
| C-24 | jest-environment-nodeとjest-environment-jsdom | E-10, E-21 | ○ |
| C-25 | @jest/fake-timersによるタイマーモック | E-10 | ○ |
| C-26 | jest-validateによる設定バリデーション | E-02, E-21 | ○ |
| C-27 | write-file-atomicによるアトミック書き込み | E-15 | ○ |
| C-28 | piratesによるrequire/importフック | E-15 | ○ |
| C-29 | VMコンテキストによるテスト分離 | E-11 | ○ |
| C-30 | @jest/test-sequencerによるテスト順序制御 | E-06, E-14 | ○ |
| C-31 | node-notifierによるデスクトップ通知（オプション） | E-01, E-02, E-04 | ○ |
| C-32 | Watchman連携によるファイル監視（オプション） | E-20 | ○ |
| C-33 | ESMサポート（SourceTextModule, SyntheticModule） | E-11 | △ |
| C-34 | V8ネイティブカバレッジサポート | E-19 | △ |
| C-35 | 階層化モジュラーアーキテクチャの採用 | **根拠なし** | △ |

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

- **C-33 ESMサポート**: ソースコードに実装は存在するが、公式ドキュメントでの機能状態（安定版/実験版）の明確な記載が確認できない
  - 候補：README.md / docs/ / 公式ウェブサイト

- **C-34 V8カバレッジ**: @jest/reportersのpackage.jsonにv8-to-istanbul等の依存が確認できるが、具体的な設定方法や制約に関する詳細情報が不足
  - 候補：jest-config / 公式ドキュメント

- **C-35 アーキテクチャスタイルの命名**: 「階層化モジュラーアーキテクチャ」という命名は分析結果からの推論であり、公式な命名ではない
  - 候補：CONTRIBUTING.md / アーキテクチャに関する公式ブログ記事

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

- **0 (低リスク)**: パッケージ依存関係、バージョン情報、Node.jsサポートバージョン
  - これらは package.json から直接確認可能

- **1 (中リスク)**: データフロー、処理フローの詳細
  - ソースコードから読み取れるが、エッジケースや非同期処理の詳細は追加確認が望ましい

- **2 (高リスク)**: ESMサポート状態、V8カバレッジの詳細仕様
  - 実装は存在するが、機能の安定性・完全性についてはドキュメント確認が必要

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

- [ ] パッケージ依存関係図が最新のpackage.jsonと一致しているか確認
- [ ] レイヤー構成の分類が実際のコード構造を適切に反映しているか確認
- [ ] データフローの記載がTestScheduler.tsおよびrunJest.tsの実装と整合しているか確認
- [ ] 設計原則（SRP, OCP等）の適用箇所が実際のコードパターンと一致しているか確認
- [ ] ESMサポートの現状について公式ドキュメントで確認
- [ ] V8カバレッジの設定方法・制約について公式ドキュメントで確認
- [ ] Watchman連携の設定オプションについて公式ドキュメントで確認
