Skip to content

Instantly share code, notes, and snippets.

@asklar
Last active March 23, 2026 08:29
Show Gist options
  • Select an option

  • Save asklar/234e163b316b571ff014e53b0fabd183 to your computer and use it in GitHub Desktop.

Select an option

Save asklar/234e163b316b571ff014e53b0fabd183 to your computer and use it in GitHub Desktop.
Agent Fleet Coordination Rules — drop into your repo to prevent multi-agent contention
name agent-fleet-rules
version 1.0.0
description Coordination rules for multi-agent development with fleets. Prevents contention, silent overwrites, and lost work when running multiple agents in parallel on the same repo.

Agent Fleet Coordination Rules

Multiple agents may run in parallel on this repo. Follow these rules.

Rules

  1. Tests before code. Every feature/fix gets a test first. Tests detect when one agent broke another's work.
  2. Never work on main. Each agent gets its own worktree and branch. git worktree add /tmp/<task> -b <branch>. All changes via PR.
  3. File-level isolation. New code in separate files (partial classes in C#/C++). Agent A: Parser.cs, Agent B: Parser.Diagnostics.cs. Zero merge conflicts.
  4. You do NOT merge. Main agent or human merges. You propose via PR only.
  5. Scope tightly. If your task touches >3-4 files, break it up.
  6. Conflict? Stop. If files changed unexpectedly, don't reconcile. Report it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment