KB

Appearance

KB初期設計と構築 ​

概要 ​

全AIエージェント（Claude Code）が読み書きする共有ナレッジベースを設計・構築した。

決定事項 ​

基本構造 ​

  • wiki（構造化知識）+ log（時系列記録）の二層構造
  • ルートディレクトリ: Documents/kb/

wiki ​

  • ディレクトリ型カテゴリ（tech, project, personal, meta）
  • カテゴリは自由追加だが _categories.md への登録必須
  • フロントマター: title, tags, category, status, related, created, updated

log ​

  • 1エントリ1ファイル
  • 月別サブディレクトリ（YYYY-MM/）
  • _latest.md で直近20件を保持
  • フロントマター: title, tags, category, status, distilled_to, created

検索戦略 ​

  • log→wiki蒸留を採用（DB化は見送り）
  • wikiを主な検索対象とし、logは日時指定時のみ参照
  • 将来的にSQLiteインデックス追加の余地あり

公開・自動化 ​

  • VitePress + Cloudflare Pages
  • Claude Codeスケジュールで自動push + 蒸留

検討したが採用しなかった案 ​

  • logのSQLite化: Git不可、Claude Codeとの親和性低
  • フラット型カテゴリ: ディレクトリ型の方が物理的に整理される
  • 1日1ファイルlog: エントリ単位の方が蒸留フローに適合