---
generated_at: 2026-02-19 12:00:00
metrics:
  claims_total: 42
  claims_with_evidence: 38
  claims_without_evidence: 4
confidence_derived: 0.90
---

# 根拠レポート：運用マニュアル.md

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.90**
  - 根拠あり：38 / 42、根拠なし：4
- 優先レビュー（高）
  1. **C-38 エディタ固有のキーバインド**：エディタごとのデフォルト設定は変更される可能性
  2. **C-39 ログファイルのパス**：OS/環境によって異なる可能性
  3. **C-40 Git hooks サンプル**：プロジェクト固有の実装例
  4. **C-42 メモリ不足対策**：環境依存の情報

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

- E-01: `docs/code-to-docs/README.md` - システム概要、技術スタック
- E-02: `docs/code-to-docs/機能設計書/1-オートコンプリート.md` - 補完機能の詳細仕様
- E-03: `docs/code-to-docs/機能設計書/3-定義へジャンプ.md` - 定義ジャンプ機能の仕様
- E-04: `docs/code-to-docs/機能設計書/11-名前空間クリーンアップ.md` - clean-ns機能の仕様
- E-05: `docs/code-to-docs/機能設計書/73-診断取得.md` - 診断機能（CLI）の仕様
- E-06: `docs/code-to-docs/機能設計書/81-フォーマット実行.md` - フォーマット機能（CLI）の仕様
- E-07: `docs/code-to-docs/画面設計書/1-該当なし.md` - LSPサーバーとしての特性説明
- E-08: `docs/code-to-docs/画面一覧/画面遷移図.md` - LSPサーバーの通信フロー
- E-09: `README.md` - プロジェクト概要、インストール方法
- E-10: `cli/src/clojure_lsp/main.clj` - CLIエントリーポイント
- E-11: `cli/src/clojure_lsp/server.clj` - LSPサーバー実装
- E-12: `lib/src/clojure_lsp/feature/completion.clj` - 補完機能実装
- E-13: `lib/src/clojure_lsp/feature/clean_ns.clj` - clean-ns機能実装
- E-14: `lib/src/clojure_lsp/feature/format.clj` - フォーマット機能実装
- E-15: `lib/src/clojure_lsp/feature/diagnostics.clj` - 診断機能実装
- E-16: `lib/src/clojure_lsp/handlers.clj` - LSPハンドラー実装
- E-17: `.cljfmt.edn` - cljfmt設定ファイル例

## 3) Claims と根拠の対応（レビューの主戦場）

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | clojure-lspはLSPサーバー実装である | E-01, E-07, E-09 | ○ |
| C-02 | VSCode、Emacs、Vim等の多様なエディタに対応 | E-07, E-09 | ○ |
| C-03 | CLIコマンドとしてCI/CDで利用可能 | E-05, E-06, E-10 | ○ |
| C-04 | コード補完機能を提供 | E-02, E-12 | ○ |
| C-05 | 定義へのジャンプ機能を提供 | E-03, E-16 | ○ |
| C-06 | 参照検索機能を提供 | E-01, E-16 | ○ |
| C-07 | リネーム機能を提供 | E-01, E-16 | ○ |
| C-08 | 名前空間整理（clean-ns）機能を提供 | E-04, E-13 | ○ |
| C-09 | コードフォーマット機能を提供 | E-06, E-14 | ○ |
| C-10 | clj-kondoによる診断機能を提供 | E-05, E-15 | ○ |
| C-11 | Homebrewでインストール可能 | E-09 | ○ |
| C-12 | インストールスクリプトが提供されている | E-09 | ○ |
| C-13 | Nixでインストール可能 | E-09 | ○ |
| C-14 | Arch LinuxでAURからインストール可能 | E-09 | ○ |
| C-15 | WindowsでScoopからインストール可能 | E-09 | ○ |
| C-16 | ネイティブバイナリがGitHub Releasesで提供 | E-09 | ○ |
| C-17 | `clojure-lsp listen`でサーバー起動 | E-07, E-10 | ○ |
| C-18 | 補完は最大600件に制限 | E-02 | ○ |
| C-19 | 補完候補には優先度順序がある | E-02 | ○ |
| C-20 | 定義ジャンプはマルチメソッドで分岐 | E-03 | ○ |
| C-21 | clean-nsは未使用要素を並列検出 | E-04 | ○ |
| C-22 | clean-nsはアルファベット順ソートを行う | E-04, E-13 | ○ |
| C-23 | フォーマットはpmapで並列処理 | E-06 | ○ |
| C-24 | フォーマットにはdry-runモードがある | E-06 | ○ |
| C-25 | 診断結果コードは0/2/3で区別 | E-05 | ○ |
| C-26 | Thread First/Last Allコードアクションが存在 | E-01 | ○ |
| C-27 | コレクション型変換機能がある | E-01 | ○ |
| C-28 | 設定ファイルは.lsp/config.ednに配置 | E-01, E-04 | ○ |
| C-29 | cljfmt設定は.cljfmt.ednで定義可能 | E-06, E-17 | ○ |
| C-30 | unused-public-var検出機能がある | E-05 | ○ |
| C-31 | CLIでformat、clean-ns、diagnosticsコマンドが使用可能 | E-05, E-06, E-10 | ○ |
| C-32 | CLIでrenameコマンドが使用可能 | E-10 | ○ |
| C-33 | CLIでreferencesコマンドが使用可能 | E-10 | ○ |
| C-34 | CLIでdumpコマンドが使用可能 | E-07, E-10 | ○ |
| C-35 | Javaクラスの補完が可能 | E-02 | ○ |
| C-36 | Javaクラスの定義ジャンプが可能 | E-03 | ○ |
| C-37 | OpenTelemetryトレーシングに対応 | E-07 | ○ |
| C-38 | VSCodeでF12で定義ジャンプ、Shift+F12で参照検索 | **根拠なし** | △ |
| C-39 | ログファイルは/tmp/clojure-lsp.*.outに出力 | **根拠なし** | △ |
| C-40 | Git hooksでpre-commitフックを設定可能 | **根拠なし** | △ |
| C-41 | .lsp/cacheを削除で解析データをクリア可能 | E-01 | ○ |
| C-42 | JVMヒープサイズ増加でメモリ不足を解消 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）

- **エディタ固有のキーバインド（C-38）**: 各エディタ・LSPクライアントのデフォルト設定は公式ドキュメントを参照すべき
  - 候補：VSCode Calva公式ドキュメント / Emacs lsp-mode公式ドキュメント / nvim-lspconfig公式ドキュメント

- **ログファイルのパス（C-39）**: OSや環境変数によって異なる可能性
  - 候補：clojure-lsp公式ドキュメントのトラブルシューティングセクション

- **Git hooks設定（C-40）**: 一般的なGitフックの設定例であり、プロジェクト固有の実装
  - 候補：プロジェクトのCONTRIBUTING.md / Git公式ドキュメント

- **メモリ不足対策（C-42）**: JVM環境依存の一般的な対策であり、clojure-lsp固有の設定ではない
  - 候補：JVM公式ドキュメント / clojure-lsp公式トラブルシューティング

## 5) リスクフラグ（レビュー観点）

| フラグ | 内容 |
|--------|------|
| 0 | システム概要、主要機能の説明 - 根拠が十分 |
| 0 | インストール方法 - READMEで確認済み |
| 0 | 補完、定義ジャンプ、clean-ns、フォーマット機能 - 機能設計書で確認済み |
| 0 | CLIコマンドの説明 - 機能設計書で確認済み |
| 1 | エディタ固有のキーバインド - エディタ/バージョンによって変更される可能性 |
| 1 | ログファイルパス - 環境依存の可能性 |
| 0 | 設定ファイルの説明 - 既存ドキュメントで確認済み |
| 1 | トラブルシューティングの一部 - 一般的なベストプラクティスに基づく |

## 6) レビュアーチェックリスト（最小）

- [ ] エディタ固有のキーバインド（VSCode、Emacs、Vim）が最新の情報と一致するか確認
- [ ] ログファイルのパスが対象OS/環境で正しいか確認
- [ ] CLIコマンドのオプションが現行バージョンと一致するか確認
- [ ] 設定ファイルの例が現行バージョンで動作するか確認
- [ ] トラブルシューティングの内容が実際の問題解決に役立つか確認
- [ ] 公式ドキュメント（clojure-lsp.io）との整合性を確認
