👥 Agent Teams

/core-features/agent-teams

Native integration with Claude Code's experimental Agent Teams feature for spawning and coordinating multiple Claude instances.

Enable Agent Teams:

bash

npx ruflo@latest init

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Agent Teams Components:

Component	Tool	Purpose
Team Lead	Main Claude	Coordinates teammates, assigns tasks, reviews results
Teammates	`Task` tool	Sub-agents spawned to work on specific tasks
Task List	`TaskCreate/TaskList/TaskUpdate`	Shared todos visible to all team members
Mailbox	`SendMessage`	Inter-agent messaging for coordination

Quick Start:

javascript

// Create a team
TeamCreate({ team_name: "feature-dev", description: "Building feature" })

// Create shared tasks
TaskCreate({ subject: "Design API", description: "..." })
TaskCreate({ subject: "Implement endpoints", description: "..." })

// Spawn teammates (parallel background work)
Task({ prompt: "Work on task #1...", subagent_type: "architect",
       team_name: "feature-dev", name: "architect", run_in_background: true })
Task({ prompt: "Work on task #2...", subagent_type: "coder",
       team_name: "feature-dev", name: "developer", run_in_background: true })

// Message teammates
SendMessage({ type: "message", recipient: "developer",
              content: "Prioritize auth", summary: "Priority update" })

// Cleanup when done
SendMessage({ type: "shutdown_request", recipient: "developer" })
TeamDelete()

Agent Teams Hooks:

Hook	Trigger	Purpose
`teammate-idle`	Teammate finishes turn	Auto-assign pending tasks
`task-completed`	Task marked complete	Train patterns, notify lead

bash

npx ruflo@latest hooks teammate-idle --auto-assign true

npx ruflo@latest hooks task-completed --task-id <id> --train-patterns

Display Modes: auto (default), in-process, tmux (split-pane)

👑 Hive Mind

🔧 MCP Tools & Integration