Open-source AI operating practice

AI Usage

AI Usage は、複数の Codex agents を同時に扱うための実務的な operating layer です。branches、worktrees、file ownership、status notes、ports、stop conditions を、作業が広がる前に明確にします。

最初の公開 artifact は Parallel Agent Orchestrator skill です。parallel work を improvisation ではなく reviewable coordination contract に変える、小さな open-source Codex skill です。

このプロジェクトについて

考え方は単純です。AI work は、agents が共有空間の形を理解しているほど安全になります。registry、task briefs、status files、port claims は、重複 edit、不明 server、merge できない final report を防ぎます。

この skill は repository-local coordination のためのものです。orchestrator が work を branches / worktrees に分け、各 agent に狭い brief を渡し、local services を意図的に予約し、merge や deploy 前に有用な status を集めるために使います。

公開境界

これは operating skill であり、hosted AI account system ではありません。Ronova accounts を作らず、private Ronova ID data を読まず、第二の identity layer も追加しません。

merge、deploy、form submission、branch deletion、spending decisions は、人間または orchestrator の明示的な承認下に残します。

helper script は local かつ dependency-free です。durable source of truth は、skill を install した repository 側に残ります。

Operating loop

この skill は、parallel AI work がほどきにくくなる前に明示化します。

01

Plan the shared state

Create a repo-local orchestration registry, task graph, branch list, merge order, file boundaries, and stop conditions before spawning agents.

02

Assign narrow work

Give each agent one branch or worktree, allowed files, forbidden files, safe commands, expected checks, and a status file to update.

03

Reserve local services

Claim ports before starting servers, record the owner and command, and avoid testing against whichever localhost process happens to answer.

04

Close with evidence

Stop after one reviewable patch, write the final status, list checks run, and surface conflicts before merge or deployment decisions.

公開ソース

公開 repository には Codex skill folder、helper script、reference templates、repository-scoped use の installation notes が入っています。

cp -R parallel-agent-orchestrator .agents/skills/GitHub repository を開く外部