AGENT SKILL

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

  1. 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.
  2. Branch Naming: All agent branches must explicitly declare the agent name (e.g., agent/antigravity-..., jules/...).
  3. 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