---
generated_at: 2026-02-18 18:05:00
metrics:
  claims_total: 42
  claims_with_evidence: 40
  claims_without_evidence: 2
confidence_derived: 0.95
---

# 根拠レポート：コードリーディングガイドライン

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.95**
  - 根拠あり：40 / 42、根拠なし：2
- 優先レビュー（高）
  1. **プラグイン数の正確性**：プラグイン総数「355以上」は実際のディレクトリ数に基づく概算
  2. **テーマ数の正確性**：テーマ総数「143以上」は実際のファイル数に基づく概算

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

- E-01: `oh-my-zsh.sh` - メインエントリーポイントスクリプト
- E-02: `lib/git.zsh` - Git関連関数定義
- E-03: `lib/functions.zsh` - ユーティリティ関数定義
- E-04: `lib/cli.zsh` - omz CLIコマンド実装
- E-05: `lib/completion.zsh` - 補完設定
- E-06: `lib/async_prompt.zsh` - 非同期プロンプト処理
- E-07: `plugins/git/git.plugin.zsh` - Gitプラグイン実装
- E-08: `themes/robbyrussell.zsh-theme` - デフォルトテーマ
- E-09: `themes/agnoster.zsh-theme` - Agnosterテーマ
- E-10: `tools/install.sh` - インストールスクリプト
- E-11: `templates/zshrc.zsh-template` - .zshrcテンプレート
- E-12: `README.md` - プロジェクト説明
- E-13: `plugins/aliases/aliases.plugin.zsh` - Aliasesプラグイン
- E-14: ディレクトリ構造のls出力結果

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Oh My ZshはZshとPOSIX準拠シェルスクリプトで構成される | E-01, E-10 | ○ |
| C-02 | `[[ ]]`はZsh固有の条件式である | E-01:50-55 | ○ |
| C-03 | `local -A`で連想配列を宣言する | E-02:46-78 | ○ |
| C-04 | case文でOS判定を行う | E-03:20-34 | ○ |
| C-05 | forループでプラグインを順次処理する | E-01:90-98 | ○ |
| C-06 | 関数定義には2つの形式がある | E-02:10-12, E-01:81-86 | ○ |
| C-07 | sourceでファイルを読み込む | E-01:197-199 | ○ |
| C-08 | autoloadで関数を遅延ロードする | E-01:79 | ○ |
| C-09 | プラグインは`plugins/プラグイン名/プラグイン名.plugin.zsh`形式 | E-01:203-206, E-07 | ○ |
| C-10 | テーマは`themes/テーマ名.zsh-theme`形式 | E-01:221-230, E-08 | ○ |
| C-11 | omzコマンドでOh My Zshを管理する | E-04:3-21 | ○ |
| C-12 | _omz_sourceパターンでエイリアス制御する | E-01:154-193 | ○ |
| C-13 | 非同期プロンプトパターンが存在する | E-06:28-43 | ○ |
| C-14 | `*.zsh`はZshスクリプトファイル | E-14 | ○ |
| C-15 | `*.zsh-theme`はテーマファイル | E-14 | ○ |
| C-16 | `*.plugin.zsh`はプラグインメインファイル | E-07, E-13 | ○ |
| C-17 | `_omz_*`は内部関数プレフィックス | E-01:154, E-06:28 | ○ |
| C-18 | `_omz::*`はCLIサブコマンドプレフィックス | E-04:205-226 | ○ |
| C-19 | `ZSH_THEME_*`はテーマ設定変数 | E-08:4-7 | ○ |
| C-20 | プラグイン数は355以上 | E-14（ls出力） | △ |
| C-21 | テーマ数は143以上 | E-14（ls出力） | △ |
| C-22 | ディレクトリ構造が説明通りである | E-14 | ○ |
| C-23 | プラグインアーキテクチャを採用している | E-01, E-07 | ○ |
| C-24 | 設定→ローダー→コア→プラグイン→テーマの層構造 | E-01, E-11 | ○ |
| C-25 | 起動フローが説明通りである | E-01:71-230 | ○ |
| C-26 | oh-my-zsh.shがエントリーポイントである | E-01 | ○ |
| C-27 | lib/cli.zshがomzコマンドを実装している | E-04 | ○ |
| C-28 | lib/git.zshがGit関連関数を提供する | E-02 | ○ |
| C-29 | キャッシュ管理が存在する | E-01:57-68 | ○ |
| C-30 | open_command関数がOS別に処理を分岐する | E-03:16-44 | ○ |
| C-31 | エイリアス定義パターンが頻繁に使用される | E-07:106-112 | ○ |
| C-32 | 関数ラッパーパターンが存在する | E-02:10-12 | ○ |
| C-33 | プロンプトセグメントパターンが存在する | E-09:126-137 | ○ |
| C-34 | プラグイン有効化フローが説明通りである | E-04:324-416 | ○ |
| C-35 | Git情報表示フローが説明通りである | E-02:14-40, E-08:1-2 | ○ |
| C-36 | README.mdがプロジェクト概要を説明している | E-12 | ○ |
| C-37 | CONTRIBUTING.mdが存在する | E-14 | ○ |
| C-38 | CODE_OF_CONDUCT.mdが存在する | E-14 | ○ |
| C-39 | SECURITY.mdが存在する | E-14 | ○ |
| C-40 | 各プラグインにREADME.mdが存在する | E-04:425-454 | ○ |
| C-41 | which/typeで関数定義場所を確認できる | Zsh標準機能 | ○ |
| C-42 | aliasコマンドでエイリアス一覧を確認できる | Zsh標準機能 | ○ |

## 4) 不足情報（Unknown / Missing）
- **プラグイン・テーマの正確な数**
  - lsコマンドの出力から概算しているが、厳密なカウントは行っていない
  - 候補：`find plugins -mindepth 1 -maxdepth 1 -type d | wc -l` / `find themes -name "*.zsh-theme" | wc -l` で正確なカウントを取得可能

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: ほぼすべての主張がソースコードから直接引用されている
- **0 (低リスク)**: ファイルパスと行番号が明示されており、検証が容易
- **1 (中リスク)**: プラグイン/テーマの総数は概算値であり、実際の数と異なる可能性がある

## 6) レビュアーチェックリスト（最小）
- [ ] 言語基礎セクションのコード例が正しいファイル・行番号を参照しているか
- [ ] ディレクトリ構造の説明が現在のプロジェクト構造と一致しているか
- [ ] 命名規則のプレフィックス/サフィックスの説明が実際のコードと一致しているか
- [ ] 業務フロー追跡の実例が実際の処理フローと一致しているか
- [ ] プラグイン/テーマの総数が概算値として適切か（正確な数が必要な場合は更新）
- [ ] 用語集の定義が正確か
- [ ] 参考資料のリンクが有効か
