What problem does it solve?
Standardizes collaboration patterns for squad agents to enable predictable worktree awareness, decision recording, and cross-agent communication, reducing miscommunication and delays.
Core Features & Use Cases
- Worktree Awareness: Use the TEAM ROOT path provided by your spawn prompt. All
.squad/ paths are relative to this root. If TEAM ROOT is not provided (rare), run git rev-parse --show-toplevel as fallback. Never assume CWD is the repo root.
- Decision Recording: After making a decision that affects other team members, write it to
.squad/decisions/inbox/{your-name}-{brief-slug}.md
- Cross-Agent Communication: If you need input, say so in your response; the coordinator will bring them in.
- Reviewer Protocol: If you have reviewer authority and reject work: the original author is locked out from revising that artifact. A different agent must own the revision. State who should revise in your rejection response.
- Anti-Patterns: Do not read all agent charters; do not write directly to
.squad/decisions/inbox; do not modify other agents' history.md; never assume CWD is repo root.
Quick Start
Record a new collaboration decision in .squad/decisions/inbox using the prescribed header and content format.
