---
generated_at: 2026-03-01 12:00:00
metrics:
  claims_total: 32
  claims_with_evidence: 29
  claims_without_evidence: 3
confidence_derived: 0.91
---

# 根拠レポート：テスト方針書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.91**
  - 根拠あり：29 / 32、根拠なし：3
- 優先レビュー（高）
  1. **カバレッジ目標が未設定という主張**：明示的な設定ファイルがないことの確認が必要
  2. **テストファイル概算行数**：正確な行数は変動する可能性がある
  3. **Discord 通知設定の詳細**：CI ワークフロー内の具体的な通知設定の確認

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

- E-01: `package.json`（ルート）- scripts セクション、devDependencies
- E-02: `vitest.config.ts`（ルート）- テストプロジェクト設定
- E-03: `packages/tailwindcss/vitest.config.ts` - スナップショットシリアライザー設定
- E-04: `packages/tailwindcss/playwright.config.ts` - Playwright 設定（ブラウザ・リトライ・ワーカー）
- E-05: `packages/@tailwindcss-browser/playwright.config.ts` - Playwright 設定
- E-06: `packages/@tailwindcss-browser/vitest.config.ts` - Vitest 設定
- E-07: `integrations/vitest.config.ts` - 統合テスト Vitest 設定
- E-08: `integrations/utils.ts` - 統合テストユーティリティ（タイムアウト・リトライ・ファイルシステム管理）
- E-09: `.github/workflows/ci.yml` - メイン CI ワークフロー
- E-10: `.github/workflows/integration-tests.yml` - 統合テスト CI ワークフロー
- E-11: `packages/tailwindcss/src/test-utils/custom-serializer.ts` - スナップショットシリアライザー
- E-12: `packages/tailwindcss/src/test-utils/run.ts` - テスト実行ヘルパー
- E-13: `packages/@tailwindcss-cli/src/utils/test-helpers.ts` - パス正規化ヘルパー
- E-14: `crates/oxide/Cargo.toml` - Rust dev-dependencies
- E-15: `packages/tailwindcss/src/*.test.ts` - 単体テストファイル群（38 ファイル）
- E-16: `integrations/cli/*.test.ts` - CLI 統合テスト
- E-17: `integrations/postcss/*.test.ts` - PostCSS 統合テスト
- E-18: `integrations/vite/*.test.ts` - Vite 統合テスト
- E-19: `crates/oxide/tests/scanner.rs` - Rust スキャナーテスト
- E-20: `packages/tailwindcss/src/__snapshots__/` - スナップショットディレクトリ

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | テストフレームワークとして Vitest v4.0.18 を使用 | E-01 | ○ |
| C-02 | E2E テストフレームワークとして Playwright v1.58.0 を使用 | E-01 | ○ |
| C-03 | Rust テストに Cargo Test を使用 | E-01, E-14 | ○ |
| C-04 | ルート vitest.config.ts で packages/* をテストプロジェクトとして統合管理 | E-02 | ○ |
| C-05 | *.spec.ts と *.test.ts の拡張子でテスト種別を区別 | E-02, E-03 | ○ |
| C-06 | Playwright で Chromium / WebKit / Firefox の 3 ブラウザをテスト | E-04 | ○ |
| C-07 | CI 環境で Playwright リトライ 2 回、ワーカー 1 に設定 | E-04 | ○ |
| C-08 | custom-serializer.ts で Color 関数の浮動小数点精度を正規化 | E-11 | ○ |
| C-09 | compileCss / run / optimizeCss ヘルパー関数の存在 | E-12 | ○ |
| C-10 | 統合テストでタイムアウト Windows 120 秒、その他 60 秒 | E-08 | ○ |
| C-11 | 統合テストで CI リトライ 2 回 | E-08 | ○ |
| C-12 | 統合テストで debug モードによるファイルシステム保持機能 | E-08 | ○ |
| C-13 | normalizeWindowsSeperators による Windows パス正規化 | E-13 | ○ |
| C-14 | CI マトリクス: ubuntu-latest / windows-latest / macos-14 | E-09, E-10 | ○ |
| C-15 | CI で Node.js v24 を使用 | E-09 | ○ |
| C-16 | CI テスト実行順: install → build → lint → test → playwright → test:ui | E-09 | ○ |
| C-17 | CI で同一 ref の前回ワークフローを自動キャンセル | E-09, E-10 | ○ |
| C-18 | 統合テスト CI マトリクス: upgrade / vite / cli / postcss / oxide / webpack | E-10 | ○ |
| C-19 | 統合テスト CI タイムアウト 30 分 | E-10 | ○ |
| C-20 | pnpm run test = cargo test && vitest run | E-01 | ○ |
| C-21 | pnpm run tdd = vitest ファイル監視モード | E-01 | ○ |
| C-22 | pnpm run bench = vitest bench | E-01 | ○ |
| C-23 | 単体テストファイル数 約 113 個 | E-15, E-16, E-17, E-18 | ○ |
| C-24 | 統合テストファイル数 約 38 個 | E-16, E-17, E-18 | ○ |
| C-25 | E2E テストファイル 2 個（tailwindcss / @tailwindcss-browser） | E-04, E-05 | ○ |
| C-26 | Rust テストファイル 3 個 | E-19 | ○ |
| C-27 | Rust dev-dependencies に tempfile 3.13.0 / pretty_assertions 1.4.1 | E-14 | ○ |
| C-28 | スナップショットテストの使用（4 つの __snapshots__ ディレクトリ） | E-20 | ○ |
| C-29 | lint チェックは Linux のみで実行 | E-09 | ○ |
| C-30 | カバレッジ目標は明示的に未設定 | **根拠なし** | △ |
| C-31 | 単体テスト概算行数 約 50,000 行 | **根拠なし** | △ |
| C-32 | CI 失敗時に Discord 通知が送信される | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-30（カバレッジ目標未設定）**: vitest.config.ts および package.json にカバレッジプラグイン（`@vitest/coverage-v8` 等）の設定・依存が見当たらないことから推定。ただし `.nycrc` や別の設定ファイルの存在は未確認
  - 候補：`.nycrc` / `vitest.config.ts の coverage セクション` / `CI ワークフロー内のカバレッジステップ`
- **C-31（テスト概算行数）**: ファイル数からの推定値であり、正確な行数カウントは実施していない
  - 候補：`wc -l` による実測 / `cloc` による計測
- **C-32（Discord 通知）**: CI ワークフロー内に通知ステップが存在する可能性があるが、ワークフロー末尾の通知設定部分を詳細確認していない
  - 候補：`.github/workflows/ci.yml の最終ステップ` / `Discord Webhook 設定`

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: テストフレームワーク・ツール情報（C-01〜C-03） - package.json から直接確認可能
- **0（低リスク）**: CI 設定情報（C-14〜C-19） - YAML ファイルから直接確認可能
- **0（低リスク）**: テストヘルパー情報（C-08〜C-13） - ソースコードから直接確認可能
- **1（中リスク）**: テストファイル規模（C-23, C-24, C-31） - ファイル数はグロブで確認可能だが行数は推定
- **1（中リスク）**: カバレッジ目標未設定（C-30） - 設定ファイル不在の確認が必要
- **1（中リスク）**: Discord 通知（C-32） - CI ワークフローの詳細確認が必要

## 6) レビュアーチェックリスト（最小）
- [ ] package.json の devDependencies で Vitest / Playwright のバージョンが正しいか確認
- [ ] CI ワークフロー（ci.yml / integration-tests.yml）のマトリクス設定が記載通りか確認
- [ ] Playwright 設定のブラウザ・リトライ設定が記載通りか確認
- [ ] カバレッジ関連の設定ファイルが本当に存在しないか確認（`@vitest/coverage-*` の依存有無）
- [ ] テストファイル数が概算と大きく乖離していないか `find` / `glob` で確認
- [ ] CI ワークフロー内の Discord 通知設定の有無を確認
