44 lines
890 B
Markdown
44 lines
890 B
Markdown
|
# 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.
|