---
generated_at: 2026-02-17 20:55:00
metrics:
  claims_total: 35
  claims_with_evidence: 32
  claims_without_evidence: 3
confidence_derived: 0.91
---

# 根拠レポート：アーキテクチャ設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.91**
  - 根拠あり：32 / 35、根拠なし：3
- 優先レビュー（高）
  1. **サポートするLuaバージョンの完全性**：README.mdには5.5が記載されているがコード内での確認が必要
  2. **プラグインシステムの詳細機能**：pluginディレクトリは存在するが詳細な仕様確認が必要
  3. **EmmyLuaCodeStyleとの連携方式**：3rdディレクトリに存在するが連携詳細は未確認

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

- E-01: `main.lua` - エントリーポイント、サービス起動
- E-02: `script/service/service.lua` - イベントループ、メモリ管理
- E-03: `script/proto/proto.lua` - JSON-RPC処理、LSPメソッド登録
- E-04: `script/provider/provider.lua` - LSPプロバイダー、メソッドハンドラー
- E-05: `script/vm/init.lua` - VMモジュール初期化、依存関係
- E-06: `script/vm/compiler.lua` - ASTコンパイラ
- E-07: `script/parser/init.lua` - パーサーモジュール構成
- E-08: `script/parser/compile.lua` - Luaソースパーシング
- E-09: `script/files.lua` - ファイル管理、キャッシュ
- E-10: `script/workspace/workspace.lua` - ワークスペース管理
- E-11: `script/pub/pub.lua` - マルチスレッド管理（Brave/Publisher）
- E-12: `script/await.lua` - 非同期処理、コルーチン管理
- E-13: `script/log.lua` - ロギングシステム
- E-14: `script/client.lua` - クライアント通信管理
- E-15: `script/config/` - 設定モジュール
- E-16: `script/core/definition.lua` - 定義検索機能
- E-17: `script/core/diagnostics/` - 診断モジュール（65ファイル以上）
- E-18: `README.md` - プロジェクト概要、機能一覧
- E-19: `3rd/` - サードパーティライブラリ
- E-20: `locale/` - 多言語対応（6言語）
- E-21: `script/cli/init.lua` - CLIモード処理
- E-22: `script/workspace/scope.lua` - スコープ管理

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | LSPを実装したLua言語向けLanguage Server | E-03, E-04, E-18 | ○ |
| C-02 | stdio/socketでLSP通信を行う | E-02, E-03 | ○ |
| C-03 | bee.filesystemでファイルシステムアクセス | E-09, E-10, E-19 | ○ |
| C-04 | レイヤードアーキテクチャを採用 | E-01, E-02, E-03, E-04 | ○ |
| C-05 | イベント駆動型のリクエスト/レスポンスモデル | E-02, E-03 | ○ |
| C-06 | Publisher/Worker（Brave）パターンを採用 | E-11 | ○ |
| C-07 | Protocol Layerはproto/でJSON-RPC処理 | E-03 | ○ |
| C-08 | Provider Layerでprovider/がLSP機能提供 | E-04 | ○ |
| C-09 | Core Layerでcore/が言語機能を実装 | E-16, E-17 | ○ |
| C-10 | VM Layerでvm/が型推論を担当 | E-05, E-06 | ○ |
| C-11 | Parser Layerでparser/がAST構築 | E-07, E-08 | ○ |
| C-12 | files.luaがファイル管理を担当 | E-09 | ○ |
| C-13 | workspace/がワークスペース管理を担当 | E-10, E-22 | ○ |
| C-14 | config/が設定管理を担当 | E-15 | ○ |
| C-15 | データベースを使用しない | E-09 | ○ |
| C-16 | インメモリでデータ管理 | E-09 | ○ |
| C-17 | bee.channelでスレッド間通信 | E-11 | ○ |
| C-18 | 65種類以上の診断機能を提供 | E-17 | ○ |
| C-19 | コード補完機能を提供 | E-04, E-18 | ○ |
| C-20 | 定義へのジャンプ機能を提供 | E-16, E-18 | ○ |
| C-21 | 参照検索機能を提供 | E-18 | ○ |
| C-22 | リネーム機能を提供 | E-18 | ○ |
| C-23 | ホバー情報を提供 | E-18 | ○ |
| C-24 | コルーチンベースの非同期処理 | E-12 | ○ |
| C-25 | log.luaでアプリケーションログを記録 | E-13 | ○ |
| C-26 | xpcallでエラーハンドリング | E-02, E-03, E-11 | ○ |
| C-27 | ファイルバージョン管理を実装 | E-09 | ○ |
| C-28 | LuaDocアノテーションを使用 | E-04, E-06 | ○ |
| C-29 | 各モジュールはテーブルmを返す形式 | E-02, E-03, E-09, E-11 | ○ |
| C-30 | Lua 5.4で実装 | **根拠なし** | △ |
| C-31 | クロスプラットフォーム対応（Windows, macOS, Linux） | E-18 | ○ |
| C-32 | Lua 5.1-5.5とLuaJITをサポート | E-18 | ○ |
| C-33 | 6言語の多言語対応 | E-20 | ○ |
| C-34 | プラグインシステムでカスタム機能追加可能 | E-18 | ○ |
| C-35 | EmmyLuaCodeStyleでコードフォーマット | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-30 Lua 5.4で実装されている**: main.luaやREADMEでLua実装バージョンの明示的な記載がないため確認が必要
  - 候補：Dockerfile / luamake設定 / bee.luaドキュメント
- **C-35 EmmyLuaCodeStyleでコードフォーマット**: 3rdディレクトリにサブモジュールとして存在するが、連携方式の詳細コード確認が必要
  - 候補：script/core/formatting.lua / provider/formatting.lua

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: レイヤー構成・モジュール依存関係 - コード構造から明確に特定可能
- **0（低リスク）**: データフロー - コード解析により確認済み
- **0（低リスク）**: 診断機能数 - ディレクトリ内ファイル数から確認
- **1（中リスク）**: 実装言語バージョン - 明示的なドキュメントがないため間接的に推定
- **1（中リスク）**: サードパーティ連携 - サブモジュールとして存在するが詳細未確認

## 6) レビュアーチェックリスト（最小）
- [ ] レイヤー構成が実際のコード構造と一致しているか確認
- [ ] モジュール依存関係の方向性が正しいか確認
- [ ] データフローの記述が実際の処理フローと一致しているか確認
- [ ] 診断機能の数（65種類以上）が正確か確認
- [ ] Lua実装バージョン（5.4）の根拠を確認
- [ ] EmmyLuaCodeStyleとの連携コードを確認
- [ ] マルチスレッド（Brave/Publisher）パターンの実装詳細を確認
