Forge Coordination
Patterns for coordinating parallel agent work.
Coordinator Protocol
- Initialize:
comms_init(project_path=".", task_description="...")
- Check learnings:
hivemind_find(query="<task keywords>")
- Select strategy:
forge_get_strategy_insights(task="<task>")
- Decompose:
forge_decompose(task="<task>", context="<learnings>")
- Create epic:
org_create_epic(epic_title="<task>", subtasks=[...])
- Spawn workers:
forge_spawn_subtask(bead_id, epic_id, subtask_title, files)
- Monitor:
comms_inbox() + forge_status(epic_id, project_key)
- Review:
forge_review(task_id, files_touched) for each worker
- Complete:
forge_complete(bead_id, summary, files_touched)
- Learn:
hivemind_store(information="...", tags="forge,<topic>")
Worker Protocol
- Initialize:
comms_init(project_path=".", task_description="...")
- Check learnings:
hivemind_find(query="<task keywords>")
- Reserve files:
comms_reserve(paths=[...], reason="...")
- Implement: Make changes to reserved files
- Report progress:
forge_progress(bead_id, progress_percent, status)
- Store learnings:
hivemind_store(information="...", tags="...")
- Complete:
forge_complete(bead_id, summary, files_touched)
File Reservation Rules
- Workers MUST reserve files before editing
- Coordinators NEVER reserve files
- Use
comms_reserve(paths=[...], exclusive=true) for exclusive access
- Release files when done:
comms_release(paths=[...])
- Emergency release:
comms_release_all() (coordinator only)
Progress Reporting
Report at milestones: 25%, 50%, 75%, 100%
forge_progress(
project_key="replicator",
agent_name="worker-1",
bead_id="<id>",
status="in_progress",
progress_percent=50,
message="Implemented core logic, starting tests"
)
Conflict Resolution
If a file reservation fails:
- Check who holds the reservation
- Send a message via
comms_send to negotiate
- Wait for release or escalate to coordinator
Source: complytime/complyctl — distributed by TomeVault.
1---2name: complyctl3description: Multi-agent coordination patterns for forge sessions Use when this capability is needed.4---56# Forge Coordination78Patterns for coordinating parallel agent work.910## Coordinator Protocol11121. **Initialize**: `comms_init(project_path=".", task_description="...")`132. **Check learnings**: `hivemind_find(query="<task keywords>")`143. **Select strategy**: `forge_get_strategy_insights(task="<task>")`154. **Decompose**: `forge_decompose(task="<task>", context="<learnings>")`165. **Create epic**: `org_create_epic(epic_title="<task>", subtasks=[...])`176. **Spawn workers**: `forge_spawn_subtask(bead_id, epic_id, subtask_title, files)`187. **Monitor**: `comms_inbox()` + `forge_status(epic_id, project_key)`198. **Review**: `forge_review(task_id, files_touched)` for each worker209. **Complete**: `forge_complete(bead_id, summary, files_touched)`2110. **Learn**: `hivemind_store(information="...", tags="forge,<topic>")`2223## Worker Protocol24251. **Initialize**: `comms_init(project_path=".", task_description="...")`262. **Check learnings**: `hivemind_find(query="<task keywords>")`273. **Reserve files**: `comms_reserve(paths=[...], reason="...")`284. **Implement**: Make changes to reserved files295. **Report progress**: `forge_progress(bead_id, progress_percent, status)`306. **Store learnings**: `hivemind_store(information="...", tags="...")`317. **Complete**: `forge_complete(bead_id, summary, files_touched)`3233## File Reservation Rules3435- Workers MUST reserve files before editing36- Coordinators NEVER reserve files37- Use `comms_reserve(paths=[...], exclusive=true)` for exclusive access38- Release files when done: `comms_release(paths=[...])`39- Emergency release: `comms_release_all()` (coordinator only)4041## Progress Reporting4243Report at milestones: 25%, 50%, 75%, 100%4445```46forge_progress(47 project_key="replicator",48 agent_name="worker-1",49 bead_id="<id>",50 status="in_progress",51 progress_percent=50,52 message="Implemented core logic, starting tests"53)54```5556## Conflict Resolution5758If a file reservation fails:591. Check who holds the reservation602. Send a message via `comms_send` to negotiate613. Wait for release or escalate to coordinator6263---64> Source: [complytime/complyctl](https://github.com/complytime/complyctl) — distributed by [TomeVault](https://tomevault.io).65<!-- tomevault:4.0:skill_md:2026-07-05 -->