---
generated_at: 2026-03-01 20:30:00
metrics:
  claims_total: 25
  claims_with_evidence: 23
  claims_without_evidence: 2
confidence_derived: 0.92
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.92**
  - 根拠あり：23 / 25、根拠なし：2
- 優先レビュー（高）
  1. **カバレッジ目標**：明示的な目標値が設定ファイル等に存在しないため、プロジェクト方針として確認が必要
  2. **不具合管理ワークフロー**：GitHubの運用方針は明文化されていないため、実際の運用と照合が必要

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

- E-01: `.github/workflows/test.yml` - CI/CDテストワークフロー定義
- E-02: `build.zig` - Zigビルドシステム・テストステップ定義
- E-03: `build.zig.zon` - Zigバージョン・依存関係定義
- E-04: `HACKING.md` - 開発者向けドキュメント（テスト方法、Valgrind使用法等）
- E-05: `Makefile` - ビルド補助スクリプト
- E-06: `test/README.md` - テストディレクトリの説明
- E-07: `nix/tests.nix` - Nix VMベース統合テスト定義
- E-08: `valgrind.supp` - Valgrind抑制ファイル
- E-09: `src/config/testdata/` - テストデータディレクトリ
- E-10: `src/terminal/kitty/testdata/` - Kittyプロトコルテストデータ
- E-11: `src/font/shaper/testdata/` - フォントシェイピングテストデータ
- E-12: `src/font/sprite/testdata/` - スプライトフォントテストデータ
- E-13: `src/crash/testdata/` - クラッシュダンプテストデータ

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Zigの組み込みテスト機能による単体テストを使用 | E-02 | ○ |
| C-02 | Zig 0.15.2を使用 | E-03 | ○ |
| C-03 | `zig build test`で単体テストを実行 | E-02, E-04 | ○ |
| C-04 | Valgrindによるメモリリーク検出を実施 | E-02, E-04, E-08 | ○ |
| C-05 | test.ymlでCI/CDテストが定義されている | E-01 | ○ |
| C-06 | Linux (x86_64/aarch64)でテストを実行 | E-01 | ○ |
| C-07 | macOS (Xcode 26)でテストを実行 | E-01, E-04 | ○ |
| C-08 | Windows 2022でビルドテストを実行 | E-01 | ○ |
| C-09 | GTK X11/Wayland組み合わせテストを実施 | E-01 | ○ |
| C-10 | SIMDオプションのテストマトリックスを実施 | E-01 | ○ |
| C-11 | zig fmt, prettier, swiftlint等でフォーマットチェック | E-01, E-04 | ○ |
| C-12 | Nix VMベースの統合テストを実施 | E-07 | ○ |
| C-13 | basic-version-check, basic-window-check-gnome等のVMテストが存在 | E-07 | ○ |
| C-14 | テストデータがsrc/配下に存在 | E-09, E-10, E-11, E-12, E-13 | ○ |
| C-15 | valgrind.suppでGTK由来のリークを抑制 | E-08 | ○ |
| C-16 | push, pull_request, workflow_dispatchでテストがトリガーされる | E-01 | ○ |
| C-17 | パスベースのフィルタリングでテストをスキップ可能 | E-01 | ○ |
| C-18 | Flatpak/Snapビルドテストを実施 | E-01 | ○ |
| C-19 | libghostty-vtの各種ターゲットビルドテスト | E-01, E-02 | ○ |
| C-20 | ベンチマークツール(benchmark/)が存在 | E-02 | ○ |
| C-21 | blueprint-compiler 0.16.0以上が必要 | E-04 | ○ |
| C-22 | test/ディレクトリにテストユーティリティが存在 | E-06 | ○ |
| C-23 | Debian 13コンテナでのビルドテスト | E-01 | ○ |
| C-24 | カバレッジ目標が明示的に設定されている | **根拠なし** | △ |
| C-25 | 不具合管理ワークフローがGitHub Issueベース | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **カバレッジ目標について**: プロジェクト内にカバレッジ目標を定義したドキュメントや設定ファイルが見つからない。Zigの標準テストフレームワークはカバレッジ計測機能を持たないため、明示的な目標値が設定されていない可能性が高い。
  - 候補：CONTRIBUTING.md / プロジェクトWiki / 開発ガイドライン
- **不具合管理ワークフローについて**: GitHub Issueを使用していることは明らかだが、具体的なワークフロー（ラベル運用、優先度設定等）の公式ドキュメントが見つからない。
  - 候補：CONTRIBUTING.md / .github/ISSUE_TEMPLATE / プロジェクト運用ガイド

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: テストツール・テスト環境に関する主張 - CI/CD設定ファイルから直接確認可能
- **0（低リスク）**: テストコマンドに関する主張 - build.zig, HACKING.mdから直接確認可能
- **1（中リスク）**: カバレッジ目標 - 明示的な目標値が存在しないことを「目標なし」と記載しているが、プロジェクト方針として確認が必要
- **0（低リスク）**: Nix VMテストに関する主張 - nix/tests.nixから直接確認可能

## 6) レビュアーチェックリスト（最小）
- [ ] テスト方針書の内容がCI/CD設定ファイル（test.yml）と整合しているか確認
- [ ] カバレッジ目標の記載について、プロジェクトオーナーに方針を確認
- [ ] 不具合管理ワークフローの記載について、実際のGitHub運用と照合
- [ ] Valgrind抑制ファイル（valgrind.supp）の内容が最新であるか確認
- [ ] Nix VMテストの説明がnix/tests.nixの実装と一致しているか確認
