Codex 自律開発基盤 V1
Linear Issueを起点に、隔離されたCodexが計画・質問・実装・テスト・commitまで行い、ホスト側OpenClawが成果をGitHubへ提出する。mainへの反映だけを人間承認で守る。
1. このProjectで実現すること
「Issueを書けば、Codexが実装を進め、判断が必要な時だけ人へ戻す」開発経路を、既存資産を壊さず最小構成で作る。
渡す
Linear Issue、対象リポジトリ、実装指示をCodexへ渡す。
任せる
計画、標準マルチエージェント、編集、テストをCodex CLIへ任せる。
聞く
要件判断が必要ならLinear Agent Sessionで質問し、同じセッションを継続する。
見える
OpenClawがCodexの進捗・質問・完了結果をLinearへ中継する。
提出する
OpenClawがGitHub Appでbranchをpushし、人間が確認できるPRを作る。
守る
main、本番、IAM、DNSなど壊れる境界だけを人間承認で保護する。
2. Linear・GitHubの正本分担
Linear：Whyと成果
事業・顧客上の目的、優先順位、納期、担当、人間の判断、複数repo・非開発作業をまたぐ成果、最終受け入れ条件を管理する。
GitHub Issue：How
repo固有の実装単位、バグ、リファクタリング、技術仕様、検証条件を管理し、Codexが実装する要求正本とする。
GitHub PR：変更成果
diff、commit、テスト、CI、レビュー、変更履歴の正本とする。LinearにはPR URLと成果要約だけを返す。
3. 全体アーキテクチャ
橙がMac miniホスト、緑がApple container、上段が外部サービス。赤い破線が安全境界。worktreeとGitHub App資格はホストに置き、コンテナには対象worktreeとCodex自身のログインだけを置く。
4. OpenClaw・Codex・人間の責務
OpenClaw：制御・中継・提出
Issue受付、repo特定、branch/worktree作成、container起動・mount、Linear中継、成果確認、GitHub App token発行、push、PR作成・更新、CI確認を担当する。コードは書かない。
Codex：開発実務
計画、調査、編集、テスト、修正、標準マルチエージェント、質問、受け入れ確認、commitを担当する。GitHub資格を持たず、push・PR・mergeは行わない。
人間：判断・承認
要件判断への回答、PRレビュー、mainへのmerge、GCP PAM昇格、例外的な本番・Cloudflare高リスク操作の承認を担当する。
5. 合意済みの設計判断
6. 権限境界
7. 実装Issueと順序
Projectの成果と判断は次の4 Linear Issueで管理する。各repositoryの実装は、そこから関連付けるGitHub Issueを正本として進める。
Codex自律開発のコア基盤
repository登録、Issue別worktree、永続container、Codex実行、質問・再開、Linear中継を構築する。
GitHubのPR提出・main保護境界
Org全repo対象GitHub App、ホスト側push・PR作成、Organization Ruleset、人間承認、CI確認を設定・検証する。
GCP・Cloudflareの本番権限境界
日常資格、PR/CI資格、GCP PAM、Cloudflare Token/IaC、監査と失効を実環境で確認する。
実repositoryでE2Eパイロット
Issue受付からCodex実装、OpenClawのPR提出、人間merge、本番反映まで通し、運用手順を確定する。
8. Project完了条件
- Linear Issueから実リポジトリのCodex実装を開始できる。
- 同一リポジトリの複数Issueが別worktreeで同時実行できる。
- Codexの質問と人間の回答が同じセッションへ戻る。
- OpenClawが進捗・質問・resume・完了結果をLinearへ中継できる。
- OpenClawがGitHub AppでPRを提出でき、CodexはGitHub資格を持たない。
- GitHub Appはmainへ直接push・mergeできず、人間の承認とmergeを必要とする。
- 本番権限がPR/CIまたはGCP PAMの人間承認を越えない。
- 実リポジトリのE2Eパイロットと復旧手順が完了する。