Forge Communication Bus

File-based inter-agent communication. No database, no message broker, just files that agents read and write.

Structure

comms/
├── inbox/          ← Per-agent message inboxes
│   ├── director/   ← Messages TO the director
│   ├── <agent>/    ← Messages TO any named agent
│   └── ...
├── broadcasts/     ← Fleet-wide announcements (all agents read)
├── results/        ← Task outputs from workers
└── README.md       ← This file

How It Works

Sending a message to an agent

Write a file to inbox/<agent-name>/<topic>.md:

# Subject Line
**From:** worker-xyz
**Priority:** normal
**Time:** 2026-04-14T12:00:00Z

Message body here.

Broadcasting to all agents

Write to broadcasts/<topic>.md. Persistent agents check this directory periodically.

Writing task results

Workers write to results/<task-name>.md using the standard format:

# Result: <task-name>
**Status:** completed | failed | blocked
**Finished:** <timestamp>

## What Was Done
## Output
## Issues Found

Conventions

• Files are append-only in inbox/ and broadcasts/
• Results are one file per task, overwrite if re-running
• Agents delete their own inbox messages after reading
• Old broadcasts are cleaned up weekly