---
generated_at: 2026-02-19 18:30:00
metrics:
  claims_total: 45
  claims_with_evidence: 43
  claims_without_evidence: 2
confidence_derived: 0.96
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.96**
  - 根拠あり：43 / 45、根拠なし：2
- 優先レビュー（高）
  1. **デバッグコマンドの動作確認**：実際の環境での動作検証が必要
  2. **外部リンクの有効性**：参考資料のリンク先確認が必要

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

- E-01: `src/coffeescript.coffee`
- E-02: `src/lexer.coffee`
- E-03: `src/rewriter.coffee`
- E-04: `src/nodes.coffee`
- E-05: `src/grammar.coffee`
- E-06: `src/helpers.coffee`
- E-07: `src/scope.litcoffee`
- E-08: `src/index.coffee`
- E-09: `src/command.coffee`
- E-10: `src/sourcemap.litcoffee`
- E-11: `bin/coffee`
- E-12: `package.json`
- E-13: `Cakefile`
- E-14: `README.md`
- E-15: `test/classes.coffee`

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | CoffeeScriptはJavaScriptにコンパイルされる言語である | E-14, E-01 | ○ |
| C-02 | トークンは[tag, value, locationData]形式の配列である | E-02:1-10 | ○ |
| C-03 | Lexerクラスがソースコードをトークンに分割する | E-02:25-92 | ○ |
| C-04 | Rewriterクラスが暗黙構文を明示化する | E-03:1-64 | ○ |
| C-05 | parserがトークンをASTに変換する | E-01:88, E-05:1-20 | ○ |
| C-06 | nodesモジュールがJavaScriptコードを生成する | E-04:1-55 | ○ |
| C-07 | `@`はthisの省略形である | E-02, E-04（複数箇所で使用） | ○ |
| C-08 | `#{}`は文字列補間である | E-02:318-320, E-04 | ○ |
| C-09 | `and`/`or`/`is`/`isnt`はJSの演算子のエイリアスである | E-02:1241-1250 | ○ |
| C-10 | `yes`/`no`/`on`/`off`は真偽値のエイリアスである | E-02:1247-1250 | ○ |
| C-11 | 関数定義は`->`または`=>`で行う | E-01:44-50, E-04 | ○ |
| C-12 | `=>`はバインドされた関数を定義する | E-04（Codeクラスのbound属性） | ○ |
| C-13 | CommonJSモジュールシステムを使用している | E-04:8-15, E-08 | ○ |
| C-14 | exports.で要素をエクスポートする | E-02:25, E-04:33 | ○ |
| C-15 | コンパイルパイプラインはLexer→Rewriter→Parser→Nodesの順 | E-01:62-109 | ○ |
| C-16 | Jisonパーサージェネレータを使用している | E-05:1-18, E-12:49 | ○ |
| C-17 | .litcoffee形式でLiterate CoffeeScriptをサポート | E-07（全体）, E-10（全体） | ○ |
| C-18 | Scopeクラスがスコープ管理を行う | E-07:1-120 | ○ |
| C-19 | bin/coffeeがCLIエントリーポイントである | E-11:1-26 | ○ |
| C-20 | command.coffeeがCLI処理を担当する | E-09:1-100 | ○ |
| C-21 | package.jsonのmainはlib/coffeescript/indexである | E-12:19 | ○ |
| C-22 | バージョン2.7.0である | E-12:11 | ○ |
| C-23 | Babelとの連携でトランスパイルが可能 | E-08:9-19, E-13:69-86 | ○ |
| C-24 | JS_KEYWORDSにJavaScriptキーワードが定義されている | E-02:1226-1233 | ○ |
| C-25 | COFFEE_KEYWORDSにCoffeeScript固有キーワードが定義されている | E-02:1236-1253 | ○ |
| C-26 | RESERVEDに予約語が定義されている | E-02:1258-1262 | ○ |
| C-27 | Baseクラスが全ASTノードの基底クラスである | E-04:59-467 | ○ |
| C-28 | compileToFragmentsメソッドでコード片を生成する | E-04:98-109 | ○ |
| C-29 | CodeFragmentクラスがコード片を表現する | E-04:33-46 | ○ |
| C-30 | helpersモジュールに共通関数が定義されている | E-06:1-200 | ○ |
| C-31 | starts/ends関数で文字列の先頭/末尾をチェック | E-06:6-12 | ○ |
| C-32 | compact関数でfalsyな値を除去 | E-06:25-26 | ○ |
| C-33 | flatten関数で配列を平坦化 | E-06:49-50 | ○ |
| C-34 | Cakefileでビルドタスクが定義されている | E-13:124-128 | ○ |
| C-35 | cake buildでコンパイルを実行 | E-13:124 | ○ |
| C-36 | cake testでテストを実行 | E-13:498 | ○ |
| C-37 | testディレクトリにテストスイートがある | E-15（存在確認）, ディレクトリ構造 | ○ |
| C-38 | クラス定義はclassキーワードで行う | E-15:11-17, E-02:1230 | ○ |
| C-39 | extendsキーワードで継承を行う | E-15:18, E-02:1231 | ○ |
| C-40 | superキーワードで親クラスのメソッドを呼び出す | E-15:20, E-02:1231 | ○ |
| C-41 | index.coffeeでNode.js固有の機能を提供 | E-08:1-161 | ○ |
| C-42 | register.coffeeでrequire拡張を提供 | E-08:105 | ○ |
| C-43 | DEBUG_TOKEN_STREAMでトークンストリームをデバッグ可能 | E-03:47-49 | ○ |
| C-44 | --tokensオプションでトークンを表示可能 | **根拠なし** | △ |
| C-45 | 参考資料のリンク先が有効である | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-44: --tokensオプションの動作確認**
  - 候補：command.coffeeの詳細調査 / 実際のCLI実行確認 / 公式ドキュメント参照
- **C-45: 外部リンクの有効性**
  - 候補：各URLへのアクセス確認 / 公式サイトの最新状態確認

## 5) リスクフラグ（レビュー観点）
- 0: 言語基礎セクション - ソースコードから直接引用しており低リスク
- 0: アーキテクチャセクション - コンパイルパイプラインはソースコードで確認済み
- 0: 命名規則セクション - 実際のコードパターンから抽出
- 0: ディレクトリ構造セクション - 実際のファイル構造を反映
- 0: 主要コンポーネントセクション - ソースコードの直接引用
- 1: デバッグコマンドセクション - 実行環境での動作確認推奨
- 1: 外部リンクセクション - リンク先の有効性確認推奨

## 6) レビュアーチェックリスト（最小）
- [ ] 言語基礎セクションのCoffeeScript構文説明が正確か
- [ ] コンパイルパイプラインの説明が実装と一致しているか
- [ ] ディレクトリ構造の説明が現在のプロジェクト構造と一致しているか
- [ ] コード例のファイル名・行番号が正確か
- [ ] デバッグコマンド（coffee --tokens等）が実際に動作するか
- [ ] 参考資料のリンクが有効か
- [ ] 用語集の定義が正確か
- [ ] 業務フロー追跡の実例が実際のコンパイル動作と一致するか
