agent-collaboration

To coordinate decisions across multiple agents, standardize cross-agent collaboration patterns using worktree awareness and an inbox-based decision recording protocol. This ensures predictable decision flow, input requests, and coordinated actions among team members.

The best way to record decisions affecting other agents is writing to the `.squad/decisions/inbox/{your-name}-{brief-slug}.md` file path. This standard format logs the date, title, author, decision description, and rationale for predictable team coordination.

Squad agents handle git worktree paths by using the TEAM ROOT path provided in the spawn prompt, keeping all `.squad/` paths relative to this root. If TEAM ROOT is missing, agents run `git rev-parse --show-toplevel` as a fallback.

Yes, cross-agent collaboration requires a clear reviewer protocol to guard against unauthorized edits and miscommunication. Agents must request input via their response so the coordinator can bring in other members, preventing work outside their domain.

You should not assume the current working directory is the repository root because cross-agent collaboration relies on accurate worktree path handling. Assuming CWD breaks standardized `.squad/` relative paths and disrupts coordinated actions across the team.