---
generated_at: 2026-03-01 15:30:00
metrics:
  claims_total: 28
  claims_with_evidence: 26
  claims_without_evidence: 2
confidence_derived: 0.93
---

# 根拠レポート：インフラ設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：26 / 28、根拠なし：2
- 優先レビュー（高）
  1. **Netlify SLA準拠**：外部サービスのSLA情報はコードから確認不可
  2. **CI/CDログ保持期間90日**：GitHub標準仕様の参照であり、コードに明示なし

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

- E-01: `.github/workflows/nodejs.yml` - メインCIワークフロー定義
- E-02: `.github/workflows/test.yml` - テストワークフロー定義（Node.jsバージョンマトリクス）
- E-03: `.github/workflows/prepare-cache.yml` - キャッシュ準備ワークフロー
- E-04: `.github/workflows/nightly.yml` - Nightlyビルドワークフロー
- E-05: `.github/workflows/close-stale.yml` - Stale Issue/PR管理ワークフロー
- E-06: `.github/workflows/lock.yml` - スレッドロックワークフロー
- E-07: `.github/workflows/pkg-pr-new.yml` - パッケージプレビュー公開ワークフロー
- E-08: `netlify.toml` - Netlify設定ファイル
- E-09: `package.json` - ルートパッケージ設定（engines、devDependencies）
- E-10: `website/package.json` - ドキュメントサイトパッケージ設定
- E-11: `lerna.json` - Lerna設定
- E-12: `.yarnrc.yml` - Yarn設定

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | GitHub Actionsを使用したCI/CD基盤 | E-01, E-02, E-03, E-04 | ○ |
| C-02 | Netlifyによるドキュメントホスティング | E-08, E-10 | ○ |
| C-03 | Ubuntu/macOS/Windowsでのマルチプラットフォームテスト | E-01 | ○ |
| C-04 | Ubuntu 4シャード、macOS 3シャード、Windows 4シャード並列実行 | E-01 | ○ |
| C-05 | Node.js 18.x/20.x/22.x/24.xでのマトリクステスト | E-02 | ○ |
| C-06 | Yarn 4.12.0（Berry）使用 | E-09, E-12 | ○ |
| C-07 | Lerna-lite ^4.3.0使用 | E-09 | ○ |
| C-08 | TypeScript ^5.8.3使用 | E-09 | ○ |
| C-09 | Webpack ^5.68.0使用 | E-09 | ○ |
| C-10 | Babel ^7.27.4使用 | E-09 | ○ |
| C-11 | Docusaurus ^3.0.0使用 | E-10 | ○ |
| C-12 | Codecov連携 | E-01 | ○ |
| C-13 | Crowdin翻訳管理連携 | E-10 | ○ |
| C-14 | テスト失敗時の自動リトライ（最大3回、タイムアウト10分） | E-01, E-02 | ○ |
| C-15 | CPUコア数に応じたmax-workers動的設定 | E-01, E-02 | ○ |
| C-16 | concurrencyグループによる重複実行キャンセル | E-01, E-04 | ○ |
| C-17 | Nightlyビルド毎日12:00 UTC実行 | E-04 | ○ |
| C-18 | Nightlyビルド失敗時のIssue自動作成 | E-04 | ○ |
| C-19 | 30日非アクティブIssueのStale化 | E-05 | ○ |
| C-20 | 90日非アクティブPRのStale化 | E-05 | ○ |
| C-21 | NODE_VERSION=20（Netlify） | E-08 | ○ |
| C-22 | NODE_OPTIONS=--max_old_space_size=4096（Netlify） | E-08 | ○ |
| C-23 | netlify-plugin-cacheによるキャッシュ最適化 | E-08 | ○ |
| C-24 | website/、docs/変更時のみ本番ビルド | E-08 | ○ |
| C-25 | 55個のパッケージをpackages/配下で管理 | E-09, E-11 | ○ |
| C-26 | enginesフィールドのNode.jsバージョン要件 | E-09 | ○ |
| C-27 | Netlify SLA準拠 | **根拠なし** | △ |
| C-28 | CI/CDログ保持期間90日 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-27（Netlify SLA準拠）**：Netlifyのサービスレベルアグリーメントは外部サービスの仕様であり、プロジェクトコード内に明示的な記載がない
  - 候補：Netlify公式ドキュメント / サービス契約書 / 外部SLA文書
- **C-28（CI/CDログ保持期間90日）**：GitHub Actionsのログ保持期間はGitHub側の標準仕様であり、プロジェクト設定ファイルには明示されていない
  - 候補：GitHub公式ドキュメント / Organization設定 / Enterprise設定

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**：CI/CD設定およびドキュメントホスティング設定はすべてリポジトリ内のファイルから直接確認可能
- **0（低リスク）**：バージョン情報はpackage.json、.yarnrc.ymlから正確に抽出
- **1（中リスク）**：外部サービス（Netlify、GitHub）の仕様に依存する記述は、サービス仕様変更時に陳腐化する可能性あり

## 6) レビュアーチェックリスト（最小）
- [ ] CI/CDワークフローファイル（.github/workflows/）の内容と設計書の記載が一致しているか確認
- [ ] Netlify設定（netlify.toml）の環境変数・ビルドコマンドが正確に反映されているか確認
- [ ] Node.jsバージョンマトリクス（18.x/20.x/22.x/24.x）がtest.ymlと一致しているか確認
- [ ] シャード数（Ubuntu:4、macOS:3、Windows:4）がnodejs.ymlと一致しているか確認
- [ ] 外部サービスのSLA・ログ保持期間は最新の公式ドキュメントを参照して補完すること
