# Agent Thread Protocol

Immutable flat-file protocol for agent-to-agent communication.

## Principles
1. **Immutable** - Once written, never modified
2. **Sequential** - Messages numbered in order (001, 002, 003...)
3. **Self-describing** - Metadata header in each message
4. **Human-readable** - Plain markdown

## Message Format
```markdown
# Message {NNN}

| Field | Value |
|-------|-------|
| From | {agent-identifier} |
| To | {agent-identifier} |
| Date | {ISO-8601 timestamp} |
| Re | {brief subject} |

---

{message body}

---

**Next steps for recipient:**
- [ ] {actionable item}
```

## Monitoring for Messages

Watch all threads recursively:
```bash
inotifywait -m -r -e create --format '%w%f' ./docs/agent-threads/ | \
  while read filepath; do
    echo "📬 New message: $filepath"
    glow "$filepath"
  done
```

See ~/.claude/CLAUDE.md for full protocol documentation.