| name | complyctl |
| description | Multi-agent coordination patterns for forge sessions Use when this capability is needed. |
| metadata | {"author":"complytime"} |
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.