> ## Documentation Index
> Fetch the complete documentation index at: https://012e27a-docs-2.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://012e27a-docs-2.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://012e27a-docs-2.manicule.dev/api/mcp.
> Every agent surface: https://012e27a-docs-2.manicule.dev/.well-known/llms-manifest.json

# Subagents Swarm Overview (/agents/overview)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 672 · updated: 2026-11-12 -->
Related: [Bhai: Lead Orchestrator & Builder](/agents/bhai.md), [Planner: Software Architect](/agents/planner.md), [Executor: Heavy Refactorer](/agents/executor.md), [Indic Multilingual Intelligence](/agents/multilingual.md), [Version Control & Git](/studio/version-control.md)

> How Bhai, Planner, and Executor divide complex tasks inside BhaiCode.

Complex software work needs different skills: architecture, fast implementation, careful
refactoring, and review. BhaiCode coordinates those roles as a **Subagents Swarm** — one
conversation on your side, specialist agents behind it.

## Swarm structure

```mermaid
flowchart TD
    YOU["You"] --> BHAI["Bhai<br/>lead orchestrator"]
    BHAI <-->|"architecture and plans"| PLANNER["Planner"]
    BHAI <-->|"refactors and migrations"| EXECUTOR["Executor"]
    BHAI <-->|"codebase search"| EXPLORER["Explorer"]
    BHAI <-->|"security review"| AUDITOR["Auditor"]
    BHAI <-->|"code quality"| REVIEWER["Reviewer"]
```

| Agent        | Role                          | Focus                                                         |
| ------------ | ----------------------------- | ------------------------------------------------------------- |
| **Bhai**     | Lead orchestrator and builder | Full-stack coding, pair programming, tool calls, debugging    |
| **Planner**  | System architect              | Requirements breakdown, data modelling, ordered roadmaps      |
| **Executor** | Heavy refactorer              | Multi-file surgery, framework migrations, test generation     |
| **Explorer** | Codebase scout                | Read-only symbol tracing, dependency mapping, file discovery  |
| **Auditor**  | Security auditor              | Vulnerability scanning, secret leaks, performance bottlenecks |
| **Reviewer** | Code reviewer                 | Lint compliance, import hygiene, code cleanliness             |

## How a task moves through the swarm

<Steps>
<Step title="You talk to Bhai">You describe the goal in English or any supported Indian language. Bhai reads the
workspace and estimates scope.</Step>

<Step title="Bhai plans or hands off">Multi-phase or architectural work goes to **Planner**. Deep refactors and migrations
go to **Executor**. Explorers and auditors run alongside when the task needs them.</Step>

<Step title="Subagents report back">Results return to Bhai, which presents the consolidated change in the
[diff viewer](/desktop/diff-viewer) for your review.</Step>
</Steps>

<CardGroup cols="3">
<Card title="Bhai" icon="sparkles" href="/agents/bhai">The primary pair-programming companion.</Card>

<Card title="Planner" icon="map" href="/agents/planner">Turns vague requirements into an ordered plan.</Card>

<Card title="Executor" icon="wrench" href="/agents/executor">Performs large, mechanical changes safely.</Card>
</CardGroup>

<Note>Delegation is automatic — you never address a subagent directly. If you want a specific
approach, say so in your prompt to Bhai.</Note>