---
generated_at: 2026-03-01 16:00:00
metrics:
  claims_total: 42
  claims_with_evidence: 39
  claims_without_evidence: 3
confidence_derived: 0.93
---

# 根拠レポート：非機能要件定義書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：39 / 42、根拠なし：3
- 優先レビュー（高）
  1. **C-09: ファイルスキャンの大規模プロジェクト秒単位完了**：具体的な計測データなし
  2. **C-14: 統合テストのデフォルトタイムアウト値**：`TEST_TIMEOUT` の具体値未確認
  3. **C-15: アサーションリトライの `ASSERTION_TIMEOUT` 値**：具体値未確認

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

- E-01: `packages/tailwindcss/src/index.bench.ts` - コンパイルベンチマーク
- E-02: `packages/tailwindcss/src/css-parser.bench.ts` - CSS パーサーベンチマーク
- E-03: `packages/tailwindcss/src/ast.bench.ts` - AST 処理ベンチマーク
- E-04: `packages/tailwindcss/src/intellisense.bench.ts` - IntelliSense ベンチマーク
- E-05: `packages/tailwindcss/src/index.ts` - メインコンパイルエントリ
- E-06: `packages/tailwindcss/src/design-system.ts` - DesignSystem とキャッシュ機構
- E-07: `packages/tailwindcss/src/compile.ts` - 候補コンパイル処理
- E-08: `packages/tailwindcss/src/utils/default-map.ts` - DefaultMap キャッシュ実装
- E-09: `packages/tailwindcss/src/utils/segment.ts` - 共有バッファ最適化
- E-10: `packages/tailwindcss/src/canonicalize-candidates.ts` - 正規化キャッシュ群
- E-11: `packages/tailwindcss/src/candidate.ts` - Arbitrary Value キャッシュ
- E-12: `packages/@tailwindcss-node/src/compile.ts` - Node.js コンパイルラッパー
- E-13: `packages/@tailwindcss-node/src/optimize.ts` - LightningCSS 最適化
- E-14: `packages/@tailwindcss-node/src/instrumentation.ts` - 計測インストゥルメンテーション
- E-15: `packages/@tailwindcss-node/src/env.ts` - DEBUG 環境変数処理
- E-16: `packages/@tailwindcss-vite/src/index.ts` - Vite プラグイン実装
- E-17: `crates/oxide/src/scanner/mod.rs` - Rust Scanner 実装
- E-18: `crates/oxide/src/fast_skip.rs` - SIMD 風ホワイトスペーススキップ
- E-19: `crates/oxide/src/throughput.rs` - スループット計測ユーティリティ
- E-20: `crates/oxide/src/scanner/init_tracing.rs` - Rust トレーシング初期化
- E-21: `crates/oxide/src/extractor/mod.rs` - 候補抽出エンジン
- E-22: `crates/oxide/Cargo.toml` - Rust 依存関係（rayon 等）
- E-23: `Cargo.toml` - ワークスペース設定 + LTO
- E-24: `package.json` - ルート package.json
- E-25: `turbo.json` - Turborepo 設定
- E-26: `vitest.config.ts` - Vitest 設定
- E-27: `rust-toolchain.toml` - Rust ツールチェイン指定
- E-28: `packages/tailwindcss/package.json` - tailwindcss パッケージ設定
- E-29: `packages/tailwindcss/tsup.config.ts` - tsup ビルド設定
- E-30: `packages/@tailwindcss-cli/package.json` - CLI パッケージ設定
- E-31: `packages/@tailwindcss-postcss/package.json` - PostCSS パッケージ設定
- E-32: `packages/@tailwindcss-vite/package.json` - Vite パッケージ設定
- E-33: `packages/@tailwindcss-node/package.json` - Node パッケージ設定
- E-34: `LICENSE` - MIT ライセンスファイル
- E-35: `packages/tailwindcss/src/feature-flags.ts` - 機能フラグ
- E-36: `integrations/utils.ts` - 統合テストユーティリティ
- E-37: `packages/tailwindcss/src/utils/escape.ts`（参照元: index.ts で import）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | CSS コンパイルのベンチマーク計測対象 | E-01 | ○ |
| C-02 | インクリメンタルビルドの `compiled ??= optimizeAst(...)` キャッシュパターン | E-05 (L755, L781, L803, L811) | ○ |
| C-03 | CSS パーサーの preflight.css ベンチマーク | E-02 | ○ |
| C-04 | AST から CSS 文字列生成のベンチマーク | E-03 | ○ |
| C-05 | Rust rayon による並列ファイルスキャン | E-17 (L19, L132), E-22 (rayon 依存) | ○ |
| C-06 | fast_skip による SIMD 風ホワイトスペーススキップ | E-18 (STRIDE=16, load/eq/or/all_true 関数) | ○ |
| C-07 | スレッド数の自動決定 (`available_parallelism`) | E-17 (ignore クレートの walk.rs L1422) | ○ |
| C-08 | Throughput 計測の実装 | E-19 (Throughput::compute) | ○ |
| C-09 | ファイルスキャンが大規模プロジェクトで秒単位完了 | **根拠なし** | △ |
| C-10 | IntelliSense ベンチマーク (getClassList, getVariants, candidatesToCss) | E-04 | ○ |
| C-11 | DefaultMap による parsedVariants/parsedCandidates/compiledAstNodes キャッシュ | E-06 (L77-L110), E-08 | ○ |
| C-12 | 11種類の正規化キャッシュ | E-10 (L116-L128) | ○ |
| C-13 | CachedInputFileSystem(fs, 4000) で4秒間キャッシュ | E-12 (L200, L230, L238) | ○ |
| C-14 | 統合テストのデフォルトタイムアウト値 | E-36 (TEST_TIMEOUT 参照あり、具体値はコード内定数) | △ |
| C-15 | アサーションリトライの ASSERTION_TIMEOUT 値 | E-36 (ASSERTION_TIMEOUT 参照あり、具体値はコード内定数) | △ |
| C-16 | CI 環境でのリトライ回数 2 回 | E-36 (L91: `retry: process.env.CI ? 2 : 0`) | ○ |
| C-17 | retryAssertion の delay=5ms とタイムアウトまで繰り返し | E-36 (L549: `delay = 5`, L551: `Date.now() + timeout`) | ○ |
| C-18 | mtime ベースのファイルキャッシュ | E-17 (L85: `mtimes: FxHashMap<PathBuf, SystemTime>`, L391-L405) | ○ |
| C-19 | 共有バッファ closingBracketStack の最適化 | E-09 (L15: `new Uint8Array(256)`, コメント L11-L14) | ○ |
| C-20 | LightningCSS の errorRecovery: true | E-13 (L54) | ○ |
| C-21 | jiti へのフォールバック | E-12 (L189-L194) | ○ |
| C-22 | has_scanned_once による初回/増分スキャン切り替え | E-17 (L87-L89, L369-L373) | ○ |
| C-23 | CSS パーサーでの入力バリデーション | E-05 (L208-L209, L229-L232, L259) | ○ |
| C-24 | dunce::canonicalize によるパス正規化 | E-17 (L155) | ○ |
| C-25 | ignore クレートによる gitignore 適用 | E-17 (L17: `use ignore::...`, L114: WalkBuilder) | ○ |
| C-26 | npm provenance 有効化 | E-28 (L69), E-30 (L29), E-31 (L24), E-32 (L21), E-33 (L21) | ○ |
| C-27 | MIT License | E-34 | ○ |
| C-28 | CSS セレクタのエスケープ処理 | E-07 (L141: `escape(candidate.raw)`), E-37 | ○ |
| C-29 | FEATURES_ENV による機能フラグ | E-35 (L1), E-29 (L16) | ○ |
| C-30 | Rust unsafe コードの限定使用 | E-17 (L341, L348: `String::from_utf8_unchecked`), E-18 (L20: `get_unchecked`) | ○ |
| C-31 | @plugin/@utility/@custom-variant による拡張性 | E-05 (L221-L253, L310-L449) | ○ |
| C-32 | @theme ディレクティブと ThemeOptions フラグ | E-05 (L85-L104, L542-L596) | ○ |
| C-33 | @source ディレクティブの not/inline 修飾子 | E-05 (L257-L307) | ○ |
| C-34 | Vite ^5.2.0 || ^6 || ^7 サポート | E-32 (L41) | ○ |
| C-35 | 多言語プリプロセッサ対応 | E-17 (L469-L487: pre_process_input) | ○ |
| C-36 | pnpm workspace + Turborepo | E-24 (packageManager), E-25 (turbo.json) | ○ |
| C-37 | TypeScript 5.5.4+ / Rust 1.85.0 | E-24 (devDependencies), E-27 (channel = "1.85.0") | ○ |
| C-38 | Vitest + Playwright テスト | E-24 (devDependencies: vitest, @playwright/test), E-26 | ○ |
| C-39 | LTO (lto = true) | E-23 (L6: `lto = true`) | ○ |
| C-40 | DEBUG 環境変数によるデバッグモード | E-15 (全体), E-20 (L7-L9) | ○ |
| C-41 | Instrumentation クラスの計測（hrtime.bigint） | E-14 (L32: `process.hrtime.bigint()`) | ○ |
| C-42 | ビルド出力へのバージョンコメント埋め込み | E-05 (L722: `comment(\`! tailwindcss v${version}\`)`) | ○ |

## 4) 不足情報（Unknown / Missing）
- C-09: 「大規模プロジェクトで秒単位完了」は推測に基づく。Rust の rayon 並列処理・mtime キャッシュ・fast_skip 最適化から高速処理は裏付けられるが、具体的な計測データや SLA は存在しない
  - 候補：プロジェクト公式ベンチマーク / 実際の大規模プロジェクトでの計測結果 / CI パフォーマンスログ
- C-14, C-15: `TEST_TIMEOUT` と `ASSERTION_TIMEOUT` の具体的な値は `integrations/utils.ts` 内の定数として定義されているが、ファイル全体を精査した範囲では数値の直接確認が不完全
  - 候補：`integrations/utils.ts` の定数定義部分の直接確認

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 性能要件の大部分はベンチマークファイルとコード実装で裏付けられている
- 0: 低リスク - セキュリティ要件はコードレベルで確認可能な項目に限定されている
- 1: 中リスク - 「大規模プロジェクトでの性能目標値」は明示的な SLA がなく、定量的な検証が困難
- 0: 低リスク - 可用性要件はビルドツールの特性上、該当なしとして適切に整理されている
- 1: 中リスク - 統合テストのタイムアウト・リトライ設定の一部定数値が未確認

## 6) レビュアーチェックリスト（最小）
- [ ] C-09 の「大規模プロジェクトで秒単位完了」の妥当性を確認する。必要に応じて実測データを補完する
- [ ] `integrations/utils.ts` の `TEST_TIMEOUT` と `ASSERTION_TIMEOUT` の具体値を確認する
- [ ] 性能要件のベンチマーク対象（`*.bench.ts`）が最新のコードと整合しているか確認する
- [ ] セキュリティ要件で CSS インジェクション等のリスクが十分にカバーされているか確認する
- [ ] 拡張性要件のプラグイン API の安定性・互換性ポリシーが文書化されているか確認する
