collaborating-agents-system

Collaborating Agents System (Coordinator + Subagent Playbook)

Use this skill when operating the collaborating-agents extension so coordinators and subagents follow the same protocol.

What this system provides

The extension gives you:

1. Agent mesh + messaging via agent_message
2. File reservation locking for write/edit coordination
3. Subagent spawning via subagent

Core tools

1) agent_message (coordination + reservations)

Actions:

• status — self identity, focus, peer count, reservations
• list — active agents
• sessions — scoped subagent run/session records; completed/failed included by default, use includeCompleted: false for active only
• session — resolve one subagent run/session record
• tail — read a concise transcript tail for one subagent run/session
• send — direct message to one peer (to, message, optional replyTo, optional urgent)
• broadcast — message all peers (message, optional urgent)
• feed — recent global message log (limit, default 20, max 400)
• thread — DM history with one peer (to, optional limit)
• reserve — reserve write/edit targets (paths, optional reason)
• release — release specific paths, or all if omitted

Delivery semantics (important):

• Normal messages (urgent: false or omitted) are delivered with Pi followUp (queued until the current turn completes).
• Urgent messages (urgent: true) are delivered with Pi steer (interrupt immediately).

Common calls:

agent_message({ action: "status" })
agent_message({ action: "list" })
agent_message({ action: "sessions" })
agent_message({ action: "sessions", includeCompleted: false })
agent_message({ action: "session", runId: "subagent-run-id" })
agent_message({ action: "tail", runId: "subagent-run-id" })
agent_message({ action: "tail", to: "latest" })
agent_message({ action: "send", to: "BlueFalcon", message: "Started task X" })
agent_message({ action: "send", to: "BlueFalcon", message: "Need decision now", urgent: true })
agent_message({ action: "broadcast", message: "Wave 2 complete" })
agent_message({ action: "thread", to: "BlueFalcon", limit: 20 })
agent_message({ action: "reserve", paths: ["src/server/"], reason: "auth refactor" })
agent_message({ action: "release", paths: ["src/server/"] })