Codex自律開発基盤 V1 鳥瞰図

どのスキルが何を規定し、どの文書・コード・設定が何を制御しているかを、方針から実行までつないだナビゲーションマップ。文書の優先順位一覧ではない。

TR-458 / 実物監査日 2026-08-14 / openclaw-linear-channel origin/main 6a78455 / codex-container-runtime origin/main 94087af

1. 実行経路の全体像

container起動条件 = 人間の明示指示 AND 関連GitHub Issue確認済み AND repository初期登録済み

2. 規定・実装・制御の対応表

所在	要素	何を規定・実装するか	実際に制御するもの	区分
workspace	`AGENTS.md`	全セッション共通の作業規律、記憶、外部更新、GitHub Issue gate	agentの判断・記録・安全な作業方法	現役
workspace	`TOOLS.md`	このMac固有の認証、repo、通知、Codex経路	環境固有の接続方法と運用事実	現役
workspace	`docs/openclaw-codex-routing.md`	Orchestrator停止、通常Codex直結、資格非注入	Codexへ委任する際の全体ルーティング	現役
skill	`linear-channel-agent-session`	Agent Session継続、起点への返答、plugin責務境界	Linear会話面での読み書き・通知先	現役
skill	`linear-to-codex-issue`	Linearの確定要求をノイズなくGitHub Issueへ翻訳し、人間承認を待つ	GitHub Issue作成・関連付け・Codexへ渡す要求本文	現役
skill	`linear-dev-workflow`	ホスト側Codexを既定とし、container利用の明示条件を判定	Apple container経路を選ぶかどうか	現役
skill	Orchestrator関連4 skills	Orchestrator、canonical worker、Observer等を起動しない	旧経路への誤ルーティング防止	停止中
config	`openclaw.json / channels.linear`	plugin有効化、token file、webhook path、secret取得先、agent id	Linear channel実行時設定	現役
repo	`openclaw-linear-channel/src/webhook.js`	署名検証、重複抑止、turn journal、session queue、progress、dispatch	Linear webhookからOpenClaw turnまでの入口	現役
repo	`src/channel-plugin-api.js` / `linear-payload.js`	channel登録、conversation ID、本文抽出、outbound	同一Agent Sessionの会話継続と返答先	現役
repo	`src/linear-client.js`	OAuth/token、GraphQL、thought/response/plan	Agent ActivityとplanのLinear実体操作	現役
repo	`openclaw-linear-channel/src/orchestrator/*`	過去のdetached runtime実装と回帰資産	現行運用では何も起動しない	履歴
repo	`codex-container-runtime/src/cli.js`	repo登録、worktree準備、container操作、run/resume	明示後のcontainer実行。起動可否の方針判断は持たない	任意経路
repo	`src/commands.js` / `runtime.js`	argv構築、process実行、JSONL保存、final result集計、relay	container内Codexの実行と証拠保存	任意経路
repo	`Containerfile` / schema / AGENTS / agent定義	固定toolchain、最終結果契約、container内の作業・レビュー規約	container内Codexの環境と振る舞い	任意経路
external	GitHub App	用途別短期tokenをホストで発行	branch push、Issue/PR操作、CI readback。mergeはしない	現役

3. 変更したい時のナビゲーション

変更したいこと	最初に見る場所	実際に直す候補	注意
Linearで会話が継続しない	`linear-channel-agent-session`、channel README / behavior	`webhook.js`、`linear-payload.js`、`channel-plugin-api.js`	Issue/Document書き戻しと混同しない
Agent Activityやplan表示を変える	channel behavior / architecture	`webhook.js`、`agent-progress-relay.js`、`terminal-response.js`	channel plumbingの範囲に限定
Linear Issue / Document / Projectを書き換える	channel `docs/writeback.md`	OpenClaw agent側のGraphQL処理	channel pluginへ判断を入れない
repo変更の要求をCodexへ渡す	`linear-to-codex-issue`	GitHub Issue本文と関連付け	人間承認前にCodexを起動しない
通常の調査・編集・検証	`openclaw-codex-routing.md`	ホスト側Codex	containerを自動選択しない
container内Codexを使う	`linear-dev-workflow`	条件成立後に`oc-runtime issue start/resume`	明示指示・GitHub Issue・repo登録の3条件
container mountやtool versionを変える	runtime README / VERSION_MANIFEST / SMOKE_RUNBOOK	`Containerfile`、`commands.js`、repo登録	Git/Git worktree互換性を実機確認
GitHub資格境界を変える	`openclaw-codex-routing.md`、`TOOLS.md`	ホスト側token発行・push/PR手順	秘密鍵/tokenをCodexへ渡さない。Appはmergeしない
旧Orchestrator資料を見る	channel `docs/source-of-truth.md`	履歴資料のみ	新規runの入口として使わない

4. 監査で確認した不一致・後続候補

要修正 container用AGENTSの要求正本

codex-container-runtime/AGENTS.md は「Linear Issueを要求の正本」としている。確定境界は、Linearが目的・判断、GitHub Issueがrepo固有の実装要求・検証条件。4つの独立レビュー役は維持し、この正本分担だけを別GitHub Issueで直す。

要整合 workspaceの起動境界表現

linear-channel-agent-session、TOOLS.md、openclaw-codex-routing.md の一部は、新しい「ホスト側Codexが既定、containerは明示時のみ」を十分に表現していない。誤読可能な箇所をworkspace側で揃える。

運用ローカルmainの追従

監査時点で両repoのローカルmainはorigin/mainより古い。棚卸しはorigin/mainを直接読んだ。履歴worktreeを壊さず、通常checkoutをどう追従確認するかは後続運用項目。

分離済み現役channelと旧runtime

openclaw-linear-channel PR #33でREADME・architecture・source-of-truthを整理済み。src/orchestrator/* は残るが、現行入口ではなく履歴・回帰資産として明示されている。

5. この図に含めない運用文書

次は鳥瞰図から独立したrunbook／台帳として扱う。必要性を確認後、別Issueへ切り出す。

repository初期登録台帳
GitHub Appの日常token発行・push・PR・CI readback・cleanup runbook
question、非zero、turn.completed欠落、relay、container、CI、配送失敗の復旧マトリクス
Codex / Git / Node / imageのupgrade・roll forward・rollback手順

6. 読み方

まず上の全体図で「判断する場所」と「実行する場所」を分ける。
次に対応表で、規定・説明・コード・設定のどれかを確認する。
変更時はナビゲーション表から入口を選び、repository変更ならGitHub Issue gateを通す。
灰色の履歴資産は参照できるが、新規runの入口にはしない。