Knowledge Ops

# ナレッジ操作

複数のストアにわたって知識を取り込み・整理・同期・検索するための多層ナレッジシステムを管理します。

ライブワークスペースモデルを優先してください:
- コード作業は実際にクローンしたリポジトリ内に置く
- アクティブな実行コンテキストは GitHub、Linear、リポジトリローカルの working-context ファイルに置く
- 広範な人間向けノートはリポジトリ外のコンテキスト/アーカイブフォルダに置くことができる
- 耐久性のあるクロスマシンメモリはシャドウリポジトリのワークスペースではなく、ナレッジベースに置く

## アクティベートするタイミング

- ユーザーがナレッジベースに情報を保存したい
- ドキュメント・会話・データを構造化されたストレージに取り込む
- システム間で知識を同期する（ローカルファイル、MCP メモリ、Supabase、Git リポジトリ）
- 既存の知識を重複排除または整理する
- ユーザーが「KB に保存して」「ナレッジを同期して」「X について何を知っているか」「取り込んで」「ナレッジベースを更新して」と言う
- 単純なメモリ呼び出しを超えたあらゆるナレッジ管理タスク

## ナレッジアーキテクチャ

### レイヤー 1: アクティブな実行の真実
- **ソース:** GitHub のイシュー、PR、ディスカッション、リリースノート、Linear のイシュー/プロジェクト/ドキュメント
- **用途:** 作業の現在の運用状態
- **ルール:** アクティブなエンジニアリング計画・ロードマップ・ロールアウト・リリースに影響する場合は、まずここに置くことを優先する

### レイヤー 2: Claude Code メモリ（クイックアクセス）
- **パス:** `~/.claude/projects/*/memory/`
- **フォーマット:** フロントマター付き Markdown ファイル
- **タイプ:** ユーザー設定、フィードバック、プロジェクトコンテキスト、リファレンス
- **用途:** 会話間で持続するクイックアクセスコンテキスト
- **セッション開始時に自動読み込み**

### レイヤー 3: MCP メモリサーバー（構造化ナレッジグラフ）
- **アクセス:** MCP メモリツール（create_entities、create_relations、add_observations、search_nodes）
- **用途:** 保存されたすべてのメモリに対するセマンティック検索、関係マッピング
- **クエリ可能なグラフ構造によるクロスセッション永続化**

### レイヤー 4: ナレッジベースリポジトリ / 耐久性ドキュメントストア
- **用途:** キュレートされた耐久性ノート、セッションエクスポート、合成されたリサーチ、オペレーターメモリ、長文ドキュメント
- **ルール:** コンテンツがリポジトリ所有のコードでない場合の、クロスマシンコンテキストの優先耐久性ストア

### レイヤー 5: 外部データストア（Supabase、PostgreSQL など）
- **用途:** 構造化データ、大規模ドキュメントストレージ、全文検索
- **最適な場面:** メモリファイルには大きすぎるドキュメント、SQL クエリが必要なデータ

### レイヤー 6: ローカルコンテキスト/アーカイブフォルダ