Repository navigation
MACS Protocol v3.1 — Capability Routing, Review Chain, Escalation, Dead Agent Reaping
What's New in v3.1
3.1 Capability Routing
Tasks can now declare requires_capabilities. Only agents with matching capabilities can claim them. Auto-claim and swarm simulation are both capability-aware.
```bash
macs create "Train embedding model" --requires ml,gpu
macs boot --agent ml-agent --capabilities ml,gpu
```
3.10 Review Chain
Agents can request peer review before marking a task done.
```bash
macs review T-009 --agent lead-opus --result approved
macs review T-009 --agent lead-opus --result rejected --note "Missing error handling"
```
3.11 Escalation Protocol
When a task hits a human decision bottleneck, escalate it. Optionally auto-resume after a timeout.
```bash
macs escalate T-012 --reason "GDPR compliance sign-off" --to cto --timeout 60
```
3.12 Dead Agent Reaping
Agents that miss heartbeats are automatically marked dead and their tasks reassigned to pending.
```bash
macs reap --threshold 45 # agents silent > 45 min → dead, tasks → pending
```
Also Included
- OpenClaw adapter (
adapters/openclaw/) - 12-task SaaS demo (
demo/setup.sh+demo/run.sh) - 111 integration tests (0 failed)
- Forced handoff, task decomposition, drift detection, swarm orchestration
Install
```bash
npm install -g macs-protocol
macs init "My Project"
macs swarm --agents "lead:architect|eng1:backend|eng2:frontend|qa:testing" --simulate
```