Busabase × OpenAI Codex
Codexのナレッジベース
Codexが読み取り、更新し、次の担当へ引き継げる長期的なプロジェクト知識を整備します。すべてのAgent出力を未確認のまま事実にする必要はありません。
不足していたレイヤー
コーディングAgentは速く動ける。プロジェクトの事実は慎重に動かす。
Codexはリポジトリ、指示、目の前のファイルをすでに理解できます。難しいのは実行後です。どの意思決定を残すのか、どの発見が検証済みなのか、次のAgentが何を事実として扱ってよいのかを決めなければなりません。
仕組み
Codexの出力を信頼できるコンテキストに変える4ステップ
承認済みコンテキストを読む
Codexはチャット履歴を組み立て直す代わりに、タスクに関連する記録、文書、ファイルを読みます。
更新を提案する
新しい発見は、変更対象のフィールドと情報源を添えたChange Requestとして届きます。
差分をレビューする
人が変更内容を確認し、修正を依頼するか、提案を承認または却下します。
正式な記録を再利用する
次回以降のCodex実行はレビュー済み知識から始まり、提案とマージの履歴も追跡できます。
残すべきもの
1回のコーディングセッションを越えて残す知識
Busabaseが最も役立つのは、後の意思決定に影響するコンテキストです。つまり、別の人やAgentが後で判断に使う情報です。
アーキテクチャ上の意思決定
決定内容、代替案、根拠、責任者、再検討する条件。
検証済みRunbook
復旧手順、環境上の制約、最後に成功した検証。
リリースとインシデントの知識
何をリリースし、何が失敗し、何をロールバックしたか、その結論を支える根拠。
再利用できるAgentワークフロー
チームの仕事の進め方を定義するSkill、レビュー用チェックリスト、データスキーマ、小さなアプリ。
適切なレイヤーを選ぶ
Busabaseはリポジトリのコンテキストを補完する。置き換えるものではない。
コードとコーディング規則はリポジトリの近くに置きます。複数のリポジトリ、Agent、アプリで使い続ける共通の事実、意思決定、運用コンテキストには、レビュー付きナレッジベースを使います。
| レイヤー | 適した用途 | 信頼性の根拠 |
|---|---|---|
| リポジトリ + AGENTS.md | コード、ローカル指示、テスト、バージョン管理された設定 | Git履歴とコードレビュー |
| ベクトル検索 | 意味的に関連する箇所の検索 | 情報源の構成と検索品質に依存 |
| 共有文書 | 人が書く説明と共同作業 | 編集責任と文書履歴 |
| Busabase | Agentが作成する記録、文書、Skill、ファイル、アプリ | Change Request、人によるレビュー、情報源、マージ履歴 |
Codexを接続
Skillを使うか、MCPで接続する
推奨する方法はBusabase Skillです。接続だけでなく、レビューのワークフローもCodexに提供します。OpenAIの公式ドキュメントによると、CodexはStreamable HTTP MCPとOAuthにも対応しています。
MCP接続
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase --scopes mcp
適合性の確認
レビューによって結果が変わる場所でBusabaseを使う
適しているケース
- 複数の人やAgentが同じ意思決定を再利用する。
- Agentによる更新に責任者、情報源、承認が必要。
- 知識が複数のリポジトリや業務システムにまたがる。
- ある値がなぜ正式な事実になったのかを再現する必要がある。
より簡単な方法がよいケース
- 情報が一時的な作業用コンテキストにすぎない。
- 成果物がすでにGit管理され、コードレビューで十分。
- 提案された更新をレビューする人がいない。
- 大量のイベント保存かベクトル検索だけが必要。
Codexのナレッジベースに関するよくある質問
CodexはBusabaseへ直接書き込めますか？
実行できる操作は付与された権限によって異なります。通常のAgent作業ではChange Request権限を使い、Codexは変更を提案し、レビューとマージは人が判断する形にします。
AGENTS.mdの代わりになりますか？
いいえ。AGENTS.mdはリポジトリ内の運用規則に適しています。Busabaseは、セッション、リポジトリ、人、Agent、アプリを越えて共有するレビュー済み知識のための場所です。
CodexはBusabase CloudとDesktopの両方を使えますか？
はい。Cloudは共有ワークスペースとブラウザベースのOAuth向けです。Personal Desktopはワークスペースを端末内に保持し、ローカルMCPエンドポイントを公開します。
Busabaseはベクトルデータベースですか？
いいえ。ベクトル検索は関連テキストを見つけるためのものです。Busabaseは構造化された記録、情報源、変更提案、人によるレビュー、正式な履歴に重点を置きます。両方を組み合わせて使えます。
最初のBaseには何を入れるべきですか？
まずは結果に影響するワークフローを1つ選びます。たとえばアーキテクチャ判断、インシデントの学び、リリース準備、検証済みRunbookです。スキーマは小さく保ち、必要に応じて情報源、責任者、状態、最終確認日を必須にします。
レビュー済みの1件から始める
チームが信頼できるコンテキストをCodexに渡す
Codexを接続し、まず1件の有用な更新を提案させます。共有知識になる前に、その差分を確認してください。