---
generated_at: 2026-02-19 10:30:00
metrics:
  claims_total: 25
  claims_with_evidence: 23
  claims_without_evidence: 2
confidence_derived: 0.92
---

# 根拠レポート：1-diagnostics

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.92**
  - 根拠あり：23 / 25、根拠なし：2
- 優先レビュー（高）
  1. **パフォーマンス要件（目標出力時間）**：具体的な数値根拠なし
  2. **想定データ件数**：実測値ではなく推定値

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

- E-01: `cli/src/clojure_lsp/main.clj` 176行目 - diagnosticsコマンド分岐
- E-02: `cli/src/clojure_lsp/main.clj` 203行目 - internal-api/diagnostics呼び出し
- E-03: `lib/src/clojure_lsp/api.clj` 128-168行目 - diagnostics関数定義とドキュメント
- E-04: `lib/src/clojure_lsp/internal_api.clj` 355-372行目 - diagnostics*実装
- E-05: `lib/src/clojure_lsp/internal_api.clj` 344-353行目 - diagnostics-by-uri関数
- E-06: `lib/src/clojure_lsp/internal_api.clj` 325-342行目 - 出力フォーマット変換
- E-07: `lib/src/clojure_lsp/feature/diagnostics.clj` 115-129行目 - find-diagnostics関数
- E-08: `lib/src/clojure_lsp/feature/diagnostics.clj` 36-64行目 - kondo-finding->diagnostic
- E-09: `lib/src/clojure_lsp/feature/diagnostics.clj` 14-25行目 - diagnostic-types定義
- E-10: `lib/src/clojure_lsp/feature/diagnostics.clj` 89-93行目 - severity->color関数
- E-11: `cli/src/clojure_lsp/main.clj` 47-115行目 - CLIオプション定義
- E-12: `帳票一覧.csv` 2行目 - diagnostics帳票定義

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | diagnosticsはプロジェクト全体の診断結果を出力する | E-03, E-04 | ○ |
| C-02 | clj-kondoのlint結果を含む | E-07, E-08 | ○ |
| C-03 | clojure-lspのカスタムlinter結果を含む | E-07, E-09 | ○ |
| C-04 | CLIコマンドは`clojure-lsp diagnostics` | E-01, E-02 | ○ |
| C-05 | API関数は`clojure-lsp.api/diagnostics` | E-03 | ○ |
| C-06 | 出力形式はテキスト/EDN/JSON | E-04, E-06 | ○ |
| C-07 | テキスト形式は`filepath:row:col: severity: [code] message` | E-06 | ○ |
| C-08 | result-codeは0/2/3を返す | E-04 (365行目) | ○ |
| C-09 | namespaceオプションで対象を絞り込み可能 | E-03, E-11 | ○ |
| C-10 | filenamesオプションで対象を絞り込み可能 | E-03, E-11 | ○ |
| C-11 | ns-exclude-regexで除外可能 | E-03, E-11 | ○ |
| C-12 | output.canonical-pathsで絶対パス出力可能 | E-03, E-06 | ○ |
| C-13 | severityは1=error, 2=warning, 3=info | E-08, E-10 | ○ |
| C-14 | clj-depend違反も検出される | E-07 (117行目) | ○ |
| C-15 | カスタム診断はdb.diagnostics.customに格納 | E-07 (113行目) | ○ |
| C-16 | built-in診断はdb.diagnostics.built-inに格納 | E-07 (110行目) | ○ |
| C-17 | jarファイルは診断対象外 | E-07 (118行目) | ○ |
| C-18 | linter levelがoffの場合は除外 | E-07 (121行目) | ○ |
| C-19 | 診断結果なしの場合は"No diagnostics found!" | E-04 (372行目) | ○ |
| C-20 | プロジェクト解析でsetup-project-and-clojure-only-deps-analysis!使用 | E-04 (357行目) | ○ |
| C-21 | diagnostics-by-uriでURI単位で診断取得 | E-05 | ○ |
| C-22 | 並列処理(pmap)で診断取得 | E-05 (347行目) | ○ |
| C-23 | 目標出力時間は初回30秒以内、キャッシュ有5秒以内 | **根拠なし** | △ |
| C-24 | 想定データ件数は数百〜数千ファイル | **根拠なし** | △ |
| C-25 | コードリーディングガイドの行番号 | E-01〜E-10 | ○ |

## 4) 不足情報（Unknown / Missing）
- パフォーマンス要件の数値根拠
  - 候補：ベンチマークテスト結果 / 実運用データ / 開発者ヒアリング
- 想定データ件数の算出根拠
  - 候補：実プロジェクト統計 / clojure-lspイシュー情報 / コミュニティ調査

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 機能仕様・API定義・処理フローは全てソースコードで確認済み
- 1: 中リスク - パフォーマンス要件は推定値のため、実測が必要な場合あり

## 6) レビュアーチェックリスト（最小）
- [ ] diagnosticsの出力形式（テキスト/EDN/JSON）が実際の動作と一致するか確認
- [ ] result-codeの値（0/2/3）がCI/CD連携で問題ないか確認
- [ ] clj-depend連携が設定で有効化されているか確認
- [ ] カスタムlinterの設定方法がドキュメントに記載されているか確認
