multi-agent-room

Multi-agent thread orchestration

Run a team of NAMED subagents that coordinate in shared THREADS, all driven by one orchestrator. Each subagent has its own identity and inbox, and posts to threads the relevant peers are members of.

When to use it

Orchestrate subagents when:

• Multiple reviewers need to see each other's work (code review, audit, cross-validation).
• A subagent should hand off findings to a peer for verification.
• The team needs a shared narrative (all readable in one thread history).
• You want to parallelize independent work (each agent runs concurrently) and then synthesize.

Setup

1. Start a thread and name its members. A thread is addressed by at least two of three coordinates — {subject, path-glob, members}. For a private team, list the members explicitly so only they see it; discovery is scoped, never global, so unrelated agents never surface it.

   agents {mode: "thread_start", subject: "review-pr-42", members: ["security", "perf"]}
   

2. Assign each subagent a short name. Pass as_agent to every tool call the subagent makes. Names like "security", "perf", "correctness" are clearer than defaults. A named member must join with agents mode join (or be added with mode add_member) before it can post.

3. Distribute the subagent contract. Each subagent's prompt should include:

   • Its assigned as_agent name (e.g. "security").
   • The shared thread's subject (e.g. "review-pr-42").
   • Instructions to:
     • Call agents {mode: "register", as_agent: "security", name: "Security Reviewer", …} once.
     • Call agents {mode: "join", thread: "review-pr-42", as_agent: "security"} to participate.
     • Call agents mode post with as_agent: "security" to share findings.
     • Call agents mode inbox with as_agent: "security" to see addressed messages.

Broadcast vs targeted hand-off

• Thread post (agents mode post + as_agent): everyone on the thread sees it. Use for:
  • Announcing a finding the whole team should see.
  • Replying to a peer's discovery (reply_to: <id> keeps it linked).
  • Summarizing your work.