A Claude Code skill for people who run several Claude Code sessions at once on the same projects. Separate sessions share no live channel, so this gives them one on disk:
| File | Scope | Answers |
|---|---|---|
ROSTER.md |
one per user, across every project | who is active right now, and where |
coordination/BOARD.md |
one per project | who owns which paths, what is locked, current state |
coordination/THREAD.md |
one per project | agent-to-agent messages, append-only |
The rules are short: register on the roster at session start, only the owner edits an
owned path, live systems outrank documents, timestamp every number you write down.
references/lessons.md has the incidents each rule came from.
Clone into your Claude Code skills directory:
git clone https://github.com/sunbowl/roster ~/.claude/skills/agent-coordinationThen paste assets/CLAUDE-snippet.md into your global ~/.claude/CLAUDE.md. The skill
carries the reasoning and templates; the CLAUDE.md block makes the startup check
unconditional, since a skill only loads when Claude decides it is relevant.
SKILL.md the skill Claude reads
assets/ROSTER.md template for the cross-project roster
assets/BOARD.md template for a project's board
assets/THREAD.md template for a project's thread
assets/CLAUDE-snippet.md block to paste into ~/.claude/CLAUDE.md
references/lessons.md the incidents behind each rule
scripts/coord.sh init / register / done / status / post helpers
scripts/coord.sh init # create coordination/ in the current project
scripts/coord.sh register <agent> <project> "<working on>"
scripts/coord.sh done <agent> "<outcome>"
scripts/coord.sh status # active rows, locks, open ACTIONs
scripts/coord.sh post <agent> <to> "<subject>" "<body>" # append to THREAD.mdThe roster lives at $COORD_ROSTER if set, else ~/Dropbox/coordination/ROSTER.md if that
directory exists, else ~/coordination/ROSTER.md.