codex-sidecar: Instructions file for Codex

AGENTS.md

この製品は退役作業中。 新規連携・機能追加は行わない。Kikoeruのcodex_generate実行時依存が残るため、その移行完了までは既存サービスを維持する。

このリポジトリで作業する Codex / エージェント向けの入口メモ。

ユーザーとの会話は日本語で行う。

このリポジトリ固有の判断は本ファイルとdocs/README.mdだけで完結させる。 特定hostのglobal instructionや別repositoryを、製品開発の必須正本にしない。

Project Purpose

codex-sidecar は、kitepon.dev の AI 開発基盤群から Codex を sidecar agent として安全に呼び出すための共通実行レイヤー。

単なる codex review CLI ではなく、Throughline / Caveat / Latticeなどの 現役プロジェクトと接続できる「AI 作業OS」の部品として設計する。Claude Code が主で動く環境に、 Codex の別視点、反対意見、レビュー、調査、限定的な修正能力を差し込む。

同時に、汎用ツールとしても成立させる。設計は「generic core」と 「kitepon.dev ecosystem overlay」の二層に分ける。generic core は他の リポジトリでも単体で使える CLI/MCP/安全実行基盤、overlay はユーザーの MCP/OAuth/hook/memory/cost 系プロジェクトに強く刺さる preset / safety profile / context adapter とする。

重要な前提:

• Claude が主導し、Codex は sidecar / second opinion として呼ばれる。
• 呼び出し元は人間だけでなく、MCP server、hook、memory tool、cost optimizer になり得る。
• 結果は人間向け文章だけでなく、他ツールが再利用できる machine-readable JSON として返す。
• このrepoは単独でinstall、設定、診断、復旧、更新、releaseできる。dotagentsは 公開contractを統合するが、製品内部の状態や運用判断を所有しない。

対象 workflow と MCP tool:

• CLI workflow review / MCP tool codex_review: diff / branch / patch の読み取り専用レビュー
• CLI workflow explore / MCP tool codex_explore: コードベース調査とファイル参照つき回答
• CLI workflow work / MCP tool codex_work: isolated git worktree 上での小さな修正
• CLI workflow opinion / MCP tool codex_opinion: 設計案への反対意見、見落とし、代替案の提示
• CLI workflow risk-check / MCP tool codex_risk_check: OAuth / MCP / secrets / Docker / hooks / CI などの重点リスク確認
• CLI workflow auditor / MCP tool codex_auditor: primary tool-use auditor 用の pass / missingTools 判定
• CLI workflow generate / MCP tool codex_generate: caller所有schemaによる任意の構造化JSON生成

製品管理用CLIはsetup、diagnostics、factory-diagnostics、factory-errors、 auth-status、auth-recoverと、耐久work用のwork-start / work-result / work-cancel / work-recover / work-auth-recoverを持つ。現在の全入口は docs/USAGE.mdを正とする。

非目的:

• 画像生成 API 課金の回避
• Codex App Server を一般 OpenAI API gateway として使うこと
• active working tree を Codex に自由編集させること
• approval prompt や危険操作を隠すこと