What problem does it solve?
Centralizes collaboration practices across squad agents to ensure consistent worktree context, standardized decision capture, and reliable cross-agent communication, reducing friction and misalignment in multi-agent workflows.
Core Features & Use Cases
- Worktree Awareness: Read TEAM ROOT from your spawn prompt and operate with paths relative to the repo root; never assume the current directory is the repository root.
- Decision Recording: After making a decision affecting teammates, write it to .squad/decisions/inbox/{your-name}-{brief-slug}.md with a header, author, and rationale.
- Cross-Agent Communication: If input from another agent is needed, ask for input and let the coordinator bring them in, preserving a centralized review flow.
- Reviewer Protocol: If you have authority but disagree, assign a different owner for revisions and clearly state who should revise in your rejection.
- Anti-Patterns: Avoid reading all agents' charters; avoid writing directly to decisions.md outside the inbox; avoid editing other agents' history.md; avoid assuming CWD is repo root.
Quick Start
Enable squad-wide collaboration by adopting the inbox-based decisions pattern and the worktree-aware spawn prompts.
