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

# Subagents Swarm Overview (/docs/agents/overview)

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

> Multi-agent coordination architecture inside BhaiCode.

Complex software engineering tasks require different skill sets: architectural design, rapid feature implementation, deep refactoring, and code review. BhaiCode coordinates these roles through the **Subagents Swarm**.

***

## Swarm Structure

```mermaid
graph TD
    USER["Developer (You)"] --> BHAI["Bhai<br/>(Lead Orchestrator & Builder)"]
    BHAI <-->|System Design & Plans| PLANNER["Planner<br/>(System Architect)"]
    BHAI <-->|Refactors & Migrations| EXECUTOR["Executor<br/>(Heavy Refactorer)"]
    BHAI <-->|Codebase Scouting| EXPLORER["Explorer<br/>(Read-Only Search)"]
    BHAI <-->|Security & Vulnerability| AUDITOR["Auditor<br/>(Security Inspector)"]
    BHAI <-->|Code Quality & Lint| REVIEWER["Reviewer<br/>(Code Reviewer)"]
```

### Core Agents

| Agent        | Role                        | Focus                                                                            |
| ------------ | --------------------------- | -------------------------------------------------------------------------------- |
| **Bhai**     | Lead Orchestrator & Builder | Direct full-stack coding, conversational pair programming, tool calls, debugging |
| **Planner**  | System Architect            | Requirements breakdown, relational database modeling, step-by-step roadmaps      |
| **Executor** | Heavy Refactorer            | Multi-file code surgery, framework migrations, test suite 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 Coordination Works

You talk directly with **Bhai**:

1. Bhai evaluates task complexity and scope.
2. For architectural or multi-phase tasks, Bhai delegates plan formulation to **Planner**.
3. For deep refactoring or migrations, Bhai hands off the multi-file transformation to **Executor**.
4. Subagents report results back to Bhai, who presents the final changes in the visual diff viewer.