# Agent Collaboration

Standard collaboration patterns for all squad agents, worktree awareness, decisions...

- Repository: https://github.com/microsoft/waza (1496 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/waza --skill agent-collaboration -g -a claude-code -y`
Codex: `npx skills add microsoft/waza --skill agent-collaboration -g -a codex -y`
Cursor: `npx skills add microsoft/waza --skill agent-collaboration -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/waza --skill agent-collaboration -g -a gemini-cli -y`

## Description

Standard collaboration patterns for all squad agents, worktree awareness, decisions, cross-agent communication

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Context

Every agent on the team follows identical collaboration patterns for worktree awareness, decision recording, and cross-agent communication. These were previously duplicated in every charter's Collaboration section (~300 bytes × 18 agents = ~5.4KB of redundant context). Now centralized here.

The coordinator's spawn prompt already instructs agents to read decisions.md and their history.md. This skill adds the patterns for WRITING decisions and requesting help.

## Patterns

### Worktree Awareness
Use the `TEAM ROOT` path provided in 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`

Format:
```
### {date}: {decision title}
**By:** {Your Name}
**What:** {the decision}
**Why:** {rationale}
```

### Cross-Agent Communication
If you need another team member's input, say so in your response. The coordinator will bring them in. Don't try to do work outside your domain.

The rest: https://github.com/microsoft/waza/blob/HEAD/.github/skills/agent-collaboration/SKILL.md