coderos-parallel-agent-coordination
Teaches how to coordinate multiple concurrent agents (Antigravity, Jules, Codex, Claude) to avoid file collisions and merge conflicts.
- License 许可
- MIT
- 最近更新
- 2026-10-07
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- coderos-parallel-agent-coordination
- description
- Teaches how to coordinate multiple concurrent agents (Antigravity, Jules, Codex, Claude) to avoid file collisions and merge conflicts.
03 SKILL.md 正文
Parallel Agent Coordination
1. Purpose
This skill establishes the protocol for managing multiple autonomous agents operating on the same CoderOS repository. It prevents merge conflicts and duplicated work by enforcing strict lane ownership and conflict resolution.
2. When to Use
Use this skill when dispatching a new agent, or when reviewing the results of an agent returning to a repository where another agent is currently active.
3. Lane Ownership Rules
- Antigravity: Local workspace docs, skills, workflows, artifacts, control-lane management.
- Jules: Remote additive PRs, focused testing, documentation for modules it creates.
- Codex: Local core implementation logic, deterministic fixes, conflict resolution.
- ChatGPT: High-level planning, PR review, architectural decisions.
4. Conflict Prevention Protocol
- File Locks: Before an agent begins work, the control lane (Antigravity/ChatGPT) checks the Work Order Ledger. Two active Work Orders must not have overlapping
allowed_paths. - Branch Naming: All agent branches must explicitly declare the agent name (e.g.,
agent/antigravity-...,jules/...). - Same-File Collision Prevention: If a shared file (e.g.,
repo_dev_runtime/__init__.py) must be modified, it is deferred to the final merge integration step executed by Codex, not the feature agents.
5. Artifact Handoff
When an agent finishes its task, it must produce the docs/templates/coderos-agent-result-handoff-template.md. The orchestrator consumes this to prepare the next agent's prompt.
6. Conflict Resolution
If a collision occurs (e.g., Jules and Antigravity both created a catalog), invoke .agents/workflows/coderos-reconcile-parallel-agents.md to deterministically choose the canonical implementation and revert the duplicate.
7. Stop Conditions
Stop execution immediately if you detect another agent has already modified your target files in the remote branch.
8. Model/Effort Guidance
- Model: Gemini 3 Pro (or equivalent High reasoning model).
- Effort: High / Deep for conflict resolution and coordination planning.
04 同仓库更多 Skills
coderos
Workspace-native skill for operating, extending, and safe parallel implementation on CoderOS itself. Use when selecting non-overlapping implementation slices, navigating CoderOS governance, scout, work-order, sandbox, and skill-pack seams, and executing safe changes.
coderos-workspace-operator
Skill for interacting with the local CoderOS Operator Workspace to coordinate tasks and prevent collisions.
coderos-workorder
Workspace-native skill for drafting valid typed CoderOS WorkOrder JSON payloads and exercising dry-run work-order dispatch safely without live execution or runtime mutation.
coderos-worker-adapters
Generates deterministic safe command packets for various workers
coderos-work-order-factory
Draft and validate deterministic CoderOS work-order factory artifacts without dispatch or provider activation.
coderos-source-reuse-auditor
Apply the Source Reuse Acceptance Auditor rubric before opening, and before merging, any PR that copies, adapts, mines, vendors, clean-room-reimplements, sidecar-wraps, or references a public repository -- the acceptance gate that sits above the license/security boundary, not a substitute for it.