Newer
Older
TelosDB / journals / 20260223-0007-仕様書の現代化とLSA化の反映.md

作業報告: 仕様書の現代化とLSA化の反映

1. 作業実施の理由と指示

  • 背景: システムの基本設計が LLM (Gemma-3) メディアから LSA (Latent Semantic Analysis) へと大きく転換されたが、docs/specification/ 内のドキュメントが旧来の src-tauri 依存や LLM 前提の記述(レガシー)のまま残っていた。
  • 意図と指示: 現状のディレクトリ構造 (src/frontend, src/backend) および、高速・軽量な LSA ベースの検索エンジンに即した内容にすべての仕様書を更新すること。

2. 指摘事項とその対応

  • 指摘: 仕様書がレガシーなままである。
    • 対応: 以下のファイルを全面的にリフレッシュした。
      • 01_system_overview.md: コア技術を LSA に変更、GPU 不要の環境要件に修正。
      • 02_architecture_design.md: 外部プロセス (llama-server) の排除、Rust 内部での SVD 解析への構成図更新。
      • 03_database_specification.md: ベクトル次元数を 640 から 50 に、ER図に items_lsa を追記。
      • 04_mcp_api_specification.md: LLM 通信エラーの記述を LSA 初期化エラー等に修正。
      • 07_ui_design_spec.md: LSA ステータス表示の記述を更新。
      • mcp.json: 通信時の 640d 記述を 50d に修正。

3. 作業詳細

AIエージェントは以下の作業を実行した:

  • docs/specification/ 内の全ファイルを走査し、src-tauri および llama-server, Gemma-3 のキーワードを検索。
  • 各ドキュメントを現状の「脱LLM・LSA特化」の設計思想に合わせて論理的に書き換え。
  • Mermaid 図解も、サイドカープロセスを持たない「シングルプロセス・マルチスレッド」構成に修正。

4. AI視点での結果

graph LR
    A[Legacy Docs] --> B{Modernization}
    B --> C[01: Concepts -> LSA]
    B --> D[02: Arch -> No Sidecar]
    B --> E[03: DB -> 50 Dimensions]
    B --> F[04/07: API/UI -> Verified]
    C & D & E & F --> G[Consistent Specification]

これにより、開発環境の混乱(古いドキュメントを見て llama-server を探すなど)を未然に防ぎ、プロジェクトの「唯一の正(Single Source of Truth)」としての仕様書が現在のソースコードと完全に一致する状態になった。