Claude Codeのナレッジベース
Claude Codeはプロジェクトを記憶できます。Busabaseは、1台の端末や1つのAgentを越えて残すべき意思決定、根拠、運用知識を、チーム全体でレビューして共有できる場所にします。
3種類の記憶
Claude Codeはすでに記憶できる。問題は、誰がどの記憶を信頼するかです。
Anthropicは永続的な指示とauto memoryを分けています。Busabaseはそこに、共同管理、構造化フィールド、情報源、提案から正式記録までの明確な経路を必要とする知識のための第3のレイヤーを加えます。
指示
Claudeが毎回のセッションで確認すべきコーディング規約、ビルドコマンド、アーキテクチャ規則、作業指針。
リポジトリが管理し、Gitでレビューします。
学習内容
同じリポジトリの後続セッションに向けてClaudeが記録する修正、好み、プロジェクトのパターン。
Claude Codeが管理し、ローカルMarkdownとして確認できます。
チーム記録
複数のAgent、リポジトリ、アプリで再利用する意思決定、根拠、Runbook、リリース状態、業務上の事実。
レビューとマージの履歴を通じてチームが管理します。
コピーせず、昇格させる
有用な発見のすべてをナレッジベースに入れる必要はない。
セッション出力の大半は一時的なままで構いません。別の人やAgentが後で利用し、レビュー担当者が根拠を確認できる発見だけをチーム知識へ昇格させます。
Claudeが再利用できる事実を見つける
制約、意思決定、依存関係、インシデントからの学びは、コードだけでは確実に導けません。
Claudeが主張と情報源を書く
提案されたBaseのフィールドによって、記録が承認される前から将来の用途が見えるようになります。
人が影響を確認する
レビュー担当者は適用範囲を修正し、根拠を求め、主張を却下するか、再利用を承認できます。
次のセッションが承認済み記録を読む
Claudeは同じ事実をもう一度推測する必要がなくなり、チームはそれが信頼されるまでの経緯を追跡できます。
並行作業
subagentには共有メモの山ではなく、引き継ぎ台帳を渡す。
Claude Codeは作業を独立したコンテキストへ委任できます。構造化されたBaseは、何を調査し、何を変更し、何が未確定で、誰が結果を承認したかという共通の契約を各担当に与えます。
使い続けられるBase
Claudeが読み取り、提案できる意思決定台帳から始める。
際限なく伸びる文書より、小さなスキーマの方が優れた記憶になります。各フィールドが、次のAgentに何を信頼でき、何を再確認すべきかを伝えます。
| フィールド | 目的 |
|---|---|
| decision | 後続のAgentが利用できる簡潔な結論。 |
| evidence | 結論を支える情報源リンク、テスト出力、元記録。 |
| scope | 適用対象のリポジトリ、サービス、顧客、環境。 |
| owner | 情報を最新に保つ責任者。 |
| verified_at | 根拠を最後に確認した日時。 |
Claude Codeの拡張スタック
各拡張機能は、実際に管理できる仕事に使う。
Claude Codeの拡張レイヤーは連携して機能します。Busabaseは外部の正式な記録システムであり、常時読み込む別のプロンプトファイルではありません。
| レイヤー | 用途 | 管理方法 |
|---|---|---|
| CLAUDE.md | 毎回読み込むプロジェクト指示 | リポジトリレビュー |
| Skill | 必要時に読む知識と再現可能なワークフロー | Skillの提供元と呼び出し |
| Hook | 決定論的なライフサイクル制御 | 実行可能なポリシー |
| MCP | 外部ツールとデータへのアクセス | サーバー権限と認証 |
| Busabase | リポジトリを越えて共有するレビュー済み記録 | Change Request、レビュー担当者、マージ履歴 |
この役割分担は、Anthropicが文書化しているCLAUDE.md、Skill、Hook、MCP、subagentの役割に基づいています。
正式記録のレイヤーを接続
セットアップは専用ページに任せる。
継続的に保守されるワークフローにはBusabase Claude Codeプラグインをインストールします。user、project、localのMCPスコープを選ぶ場合は接続ガイドを使います。接続後は、読み取り権限とレビュー可能なBaseを1つ用意するところから始めます。
最初のワークフロー
アーキテクチャ意思決定台帳
- 読み取り
- このサービスで承認済みの意思決定
- 提案
- 根拠と適用範囲を含む新しい意思決定
- レビュー
- 責任者が影響と鮮度を確認
- 再利用
- 次のセッションは承認済み記録から開始
チームからよく出る質問
Claude Codeのナレッジベースに関するFAQ
BusabaseはCLAUDE.mdやauto memoryの代わりになりますか?
いいえ。指示はCLAUDE.mdに、端末内の学習内容はauto memoryに残します。構造化フィールド、共同管理、情報源、レビュー履歴が必要な知識にBusabaseを使います。
複数のClaude Code Agentが同じナレッジベースを使えますか?
はい。複数のAgentが同じ承認済み記録を読みながら、個別に提案を送れます。レビューによって、並行作業が共有知識を密かに上書きすることを防ぎます。
Claude CodeはBusabaseへ直接書き込めますか?
アクセス範囲はAPI Keyの権限レベルに従います。チーム知識にはChange Request権限を使い、Claudeが提案し、レビュー担当者が正式記録へマージする内容を管理します。
アーキテクチャの意思決定はGitにも残すべきですか?
コードが所有する成果物はGitに残します。同じ判断が他のリポジトリ、サポート、運用、プロダクト業務、コード以外のアプリにも影響する場合は、Busabaseの意思決定台帳が役立ちます。
これはClaude Code向けのベクトル記憶ですか?
いいえ。ベクトル検索は関連する文章を見つけます。Busabaseは、誰が構造化された変更を提案し、どの根拠が支え、誰がレビューし、どの値が正式記録になったかを残します。
1回の修正をチーム知識に変える
次のClaude Codeセッションを承認済みの意思決定から始める
小さなBaseを1つ作ってClaude Codeを接続し、チームがレビューして再利用できる発見だけを正式な知識へ昇格させます。