---
generated_at: 2026-03-01 10:15:00
metrics:
  claims_total: 22
  claims_with_evidence: 21
  claims_without_evidence: 1
confidence_derived: 0.95
---

# 根拠レポート：14-benchmark.md

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.95**
  - 根拠あり：21 / 22、根拠なし：1
- 優先レビュー（高）
  1. **目標処理時間の妥当性**：「数十分〜数時間」という見積もりは実測値に基づいていない

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。

- E-01: `package.json` - scriptsセクション（benchmark定義、行52）
- E-02: `test/BenchmarkTestCases.benchmark.mjs` - ソースコード全体（1261行）
- E-03: `test/BenchmarkTestCases.benchmark.mjs` - V8フラグ検証（行34-43）
- E-04: `test/BenchmarkTestCases.benchmark.mjs` - ベースラインリビジョン取得（行112-151）
- E-05: `test/BenchmarkTestCases.benchmark.mjs` - ベースライン環境構築（行199-258）
- E-06: `test/BenchmarkTestCases.benchmark.mjs` - ベンチマークケース検索（行1081-1110）
- E-07: `test/BenchmarkTestCases.benchmark.mjs` - シナリオ定義（行432-446）
- E-08: `test/BenchmarkTestCases.benchmark.mjs` - tinybench設定（行768-789）
- E-09: `test/BenchmarkTestCases.benchmark.mjs` - t分布テーブル（行157-185）
- E-10: `test/BenchmarkTestCases.benchmark.mjs` - SHARD処理（行1112-1155）
- E-11: `test/BenchmarkTestCases.benchmark.mjs` - FILTER/NEGATIVE_FILTER（行1081-1089）
- E-12: `test/BenchmarkTestCases.benchmark.mjs` - プロファイリング（行339-387）
- E-13: `test/BenchmarkTestCases.benchmark.mjs` - CodSpeed連携（行516-765）
- E-14: `test/BenchmarkTestCases.benchmark.mjs` - watchシナリオ（行853-1045）
- E-15: `test/BenchmarkTestCases.benchmark.mjs` - 結果出力（行1207-1258）
- E-16: `docs/code-to-docs/バッチ一覧/バッチ一覧.csv` - No.14の説明
- E-17: `package.json` - devDependencies（tinybench: ^6.0.0、行190）
- E-18: `package.json` - devDependencies（@codspeed/core: ^5.2.0、行119）
- E-19: `package.json` - devDependencies（simple-git: ^3.28.0、行186）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | benchmarkスクリプトは複数のV8フラグ付きでBenchmarkTestCases.benchmark.mjsを実行する | E-01 | ○ |
| C-02 | V8フラグに--no-opt、--predictable、--max-old-space-size=4096等が含まれる | E-01 | ○ |
| C-03 | V8フラグの検証ロジックが存在する | E-03 | ○ |
| C-04 | ベースラインリビジョンはgit rev-listから取得する | E-04 | ○ |
| C-05 | LAST_COMMIT設定時はHEADのみベンチマーク | E-04（行113-119） | ○ |
| C-06 | HEAD/BASE環境変数で手動指定可能 | E-02（行55-56, 74-75） | ○ |
| C-07 | BASEリビジョンのソースコードをgit reset --hardでチェックアウトする | E-05（行245-251） | ○ |
| C-08 | ベンチマークケースはtest/benchmarkCases/から検索される | E-06（行1091） | ○ |
| C-09 | FILTER環境変数でフィルタリング可能 | E-11 | ○ |
| C-10 | SHARD環境変数で分割実行可能 | E-10 | ○ |
| C-11 | シナリオは3種類（development、development-rebuild、production） | E-07 | ○ |
| C-12 | tinybenchのウォームアップは2回、本測定は8回 | E-08（行772, 773） | ○ |
| C-13 | tinybenchのthrowsはtrue（エラー即座スロー） | E-08（行770） | ○ |
| C-14 | hrtimeNow高精度タイマーを使用 | E-08（行769） | ○ |
| C-15 | t分布による90%信頼区間（両側検定）を使用する | E-09 | ○ |
| C-16 | watchシナリオではエントリファイルに書き込みを行いリビルドをトリガーする | E-14（行906-924） | ○ |
| C-17 | PROFILE環境変数設定時にCPUプロファイルを生成する | E-12 | ○ |
| C-18 | CPUプロファイルはtest/js/benchmark/profiles/に出力される | E-12（行341, 378-384） | ○ |
| C-19 | CodSpeed連携はsimulation、memory、walltimeの3モードに対応 | E-13（行537, 760） | ○ |
| C-20 | ロングベンチマーク（-long付き）は均等に分散配置される | E-06（行1103-1110） | ○ |
| C-21 | 結果出力でHEAD vs BASEの性能比較をfaster/slower/sameで表示する | E-15（行1253-1257） | ○ |
| C-22 | 目標処理時間は数十分〜数時間 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- 実際のベンチマーク実行時間に関するデータが存在しないため、処理時間の見積もりは推定値である
  - 候補：CIパイプラインの実行ログ / ベンチマーク実行結果のアーカイブ

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - benchmarkスクリプトの構成はpackage.jsonから明確に確認可能
- 0: 低リスク - BenchmarkTestCases.benchmark.mjsの処理フローはソースコードから詳細に確認可能
- 1: 中リスク - ベースライン構築時のgit操作は、リポジトリの状態に依存するため、環境差異による問題が発生する可能性がある

## 6) レビュアーチェックリスト（最小）
- [ ] package.jsonのbenchmarkスクリプトに指定されたV8フラグが正しいか確認
- [ ] BenchmarkTestCases.benchmark.mjsのtinybench設定（iterations、warmupIterations）が正しいか確認
- [ ] シナリオ定義（development、development-rebuild、production）が正しいか確認
- [ ] t分布テーブルの値が統計的に正しいか確認
- [ ] watchシナリオのファイル変更シミュレーションが適切に動作するか確認
- [ ] CodSpeed連携の3モード（simulation、memory、walltime）の動作を確認
