Codexを複数の専門agentと明示的な権限境界で運用し、成果の正しさ・検証可能性・安全性を高めるためのGuild runtimeテンプレートです。 task contract、risk-based delegation、Trial、evidence_state、Ledgerなどの仕組みを導入します。

Codexに実装、調査、検証、Git操作などを任せつつ、対象範囲や権限を明確に管理したい開発者・チームに向いています。 特に、複数リポジトリや安全性を重視する開発で役立ちます。

いいえ。 agent-guild-orchestraは独立したOSSであり、OpenAIによる公式提供、提携、承認を受けたプロジェクトではありません。 CodexやOpenAIの名称に関する権利は各権利者に帰属します。

通常の対話に、役割分担、対象リポジトリ境界、権限確認、検証根拠、snapshot、Ledgerなどの運用契約を加えます。 作業内容に応じて最小限のworkflowを選び、高リスクな変更では独立したTrialを要求します。

いいえ。 説明やread-only調査はRootが直接行い、明白で小さな変更は一つのbounded assignmentとして扱います。 独立した委譲が品質や速度を改善する場合だけsubagentを利用します。

いいえ。 本プロジェクトの安全境界は運用を支援する契約であり、OS、container、GitHub、Codex、外部サービスのアクセス制御を代替しません。 利用環境に応じた権限管理とレビューが別途必要です。

現在の公開バージョンは1.1.0です。 将来の更新状況はGitHubのReleasesとCHANGELOG.mdで確認してください。 https://github.com/nir-nmttg/agent-guild-orchestra/releases

Git、Docker EngineまたはDocker Desktop、project-local設定とcustom agentを利用できるCodex環境が必要です。 Docker imageの初回build時には、外部registryとPython package indexへ接続できるネットワークも必要です。

通常は必要ありません。 installerとvalidatorはDocker内のPythonを利用する設計です。 GitとDockerを利用できる環境を用意してください。

macOSとLinuxを主な対象としています。 WindowsではWSL2とDocker Desktopを利用する構成を想定しています。 環境固有の差異があるため、導入前にmake validateとdry-runを実行してください。

agent-guild-orchestraの設定、runtime状態、実作業リポジトリをまとめて配置する親ディレクトリです。 Guild root直下にAGENTS.md、.agents、.codex、.orchestra、repositoriesなどが作成されます。

子リポジトリやrepositoriesディレクトリそのものではなく、その親となるGuild rootを--targetへ指定します。 例は/path/to/guild-rootです。

導入後、各リポジトリを<guild-root>/repositories/<repo>へ配置します。 agentが扱う対象は、この配下にある各リポジトリの実Git rootへ固定されます。

はい。 repositories配下へ複数のリポジトリを配置できます。 ただし、各taskでは対象リポジトリを明示的に固定し、探索・編集・検証・Git操作の範囲をその境界外へ広げません。

次の順番で進めます。 1. git clone https://github.com/nir-nmttg/agent-guild-orchestra.git 2. cd agent-guild-orchestra 3. make validate 4. ./scripts/install.sh --target /path/to/guild-root --mode copy --dry-run 5. 内容を確認後、./scripts/install.sh --target /path/to/guild-root --mode copy --backup 6. 実作業リポジトリを<guild-root>/repositories/<repo>へ配置します。

はい。 install.shへ--dry-runを付けると、書き込まずに作成・更新予定を確認できます。 配布物の初回導入経路だけを確認する場合はmake install-dry-runも利用できます。

現在はcopy modeだけを提供しています。 install.shを実行するときは--mode copyを指定してください。

主にAGENTS.md内の管理ブロック、.agents/orchestra、プロジェクト所有の.agents/skills、.codex、.orchestra、repositoriesディレクトリ、.git/info/exclude内の管理ブロックです。 --dry-runで実際の予定範囲を必ず確認してください。

いいえ。 通常導入・更新・クリーンインストールのいずれでも、repositoriesとその配下は保持され、移動・削除・backupの対象にもなりません。 手動復元やアンインストール時も触れないでください。

Gitリポジトリへ導入すると、.git/info/exclude内に本プロジェクトの管理ブロックを追加できます。 この処理を省略する場合は--no-git-excludeを指定します。 既存内容は管理ブロック外を保持します。