# Agent Communication Guide

This repo is used by Clawdbot agents for communication and code management.

## Agents That Use This Repo

| Agent | Role | Actions |
|-------|------|---------|
| **Dev Agent** | Creates task specs | Opens issues, reviews PRs |
| **Security Agent** | Scans for vulnerabilities | Comments on PRs, opens security issues |
| **System Agent** | Monitors system health | Opens incident issues |
| **CC (Claude Code)** | Executes code tasks | Picks up issues, pushes code, opens PRs |

## Labels

See `COMMS.md` in the Clawdbot workspace for full label definitions.

Quick reference:
- `status:ready` = Ready for CC
- `status:wip` = CC working
- `status:review` = Done, needs QA
- `priority:p1` = Critical

## For CC (Claude Code)

When you pick up an issue:
1. Change label to `status:wip`
2. Do the work
3. Push code / open PR
4. Comment with completion status
5. Change label to `status:review`

## For Humans

If you see issues from agents:
- `agent:dev` = Dev Agent created this spec
- `agent:security` = Security finding, prioritize
- `agent:system` = System incident report