<div align="center">

🏠 Home › 🔧 Implementation › 🏛️ Architecture › 🐔 Layer 2: Main Agent

← 🙋‍♀️ User Layer ━━━━━━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━ 🔀 Delegation Layer →

</div>

---

🐔 Layer 2: Main Agent Layer

Central orchestrator that interprets intent and coordinates execution.

---

Purpose

The Main Agent Layer is the brain of the system. It receives normalized input from the User Layer, determines the appropriate execution strategy, and coordinates all downstream work.

---

Responsibilities

---

Critical Rule

The 🐔 Main Agent is the ONLY entity that can spawn 🐦 Subagents.

🐦 Subagents cannot spawn other subagents. All delegation flows through the 🐔 Main Agent.

---

Diagram

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart TB
    classDef main fill:#8b5cf6,stroke:#7c3aed,stroke-width:2px,color:#ffffff
    classDef user fill:#6366f1,stroke:#4f46e5,stroke-width:2px,color:#ffffff
    classDef tool fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff

    subgraph MainAgentLayer["🐔 Main Agent Layer"]
        direction TB
        INTENT[Intent Recognition]
        PATTERN[Pattern Selection]
        DELEGATE[Task Delegation]
        SYNTH[Result Synthesis]

        INTENT --> PATTERN
        PATTERN --> DELEGATE
        DELEGATE --> SYNTH
    end

    INPUT["🙋‍♀️📥 User Input"]:::user --> INTENT
    SYNTH --> OUTPUT["💁‍♀️📤 User Response"]:::user
    DELEGATE --> EXEC["⚡ Execution Layer"]:::tool
    EXEC --> SYNTH

    classDef mainBox fill:#f3e8ff,stroke:#8b5cf6,stroke-width:2px,color:#5b21b6

    MainAgentLayer:::mainBox

---

Decision Points

%%{init: {'theme': 'base', 'themeVariables': {'lineColor': '#64748b'}}}%%
flowchart TD
    classDef start fill:#10b981,stroke:#059669,stroke-width:2px,color:#ffffff
    classDef wizard fill:#14b8a6,stroke:#0d9488,stroke-width:2px,color:#ffffff
    classDef parallel fill:#3b82f6,stroke:#2563eb,stroke-width:2px,color:#ffffff

    START["🙋‍♀️📥 User Request"]:::start --> Q1{Complex task?}
    Q1 -->|Yes| Q2{Independent subtasks?}
    Q1 -->|No| DIRECT[Direct Execution]

    Q2 -->|Yes| PARALLEL["🚂 Parallel Subagents"]:::parallel
    Q2 -->|No| Q3{Requires confirmation?}

    Q3 -->|Yes| WIZARD["🧙 Wizard Workflow"]:::wizard
    Q3 -->|No| SEQUENTIAL[Sequential Execution]

---

Processing Pipeline

1. Intent Recognition

Input: "Fix the login bug and add tests"
 │
 ├─► Bug fix task identified
 └─► Test addition task identified

2. Pattern Selection

3. Task Delegation

# Simple task
🐔 Main Agent → 🔧 Built-in Tools

# Complex task
🐔 Main Agent → 🪺 Task(subagent_type="code-reviewer")

# Parallel tasks
🐔 Main Agent → [🪺 Task(...), 🪺 Task(...), 🪺 Task(...)]

4. Result Synthesis

🐦 Subagent 1 → Result 1 ─┐
🐦 Subagent 2 → Result 2 ─┼─► 🐔 Merge → 💁‍♀️📤 Final Response
🐦 Subagent 3 → Result 3 ─┘

---

Layer Position

┌─────────────────────────────────────────────────────┐
│  🙋‍♀️ LAYER 1: USER LAYER                           │
│  Human input, 🦴 /commands, natural language        │
└─────────────────────────┬───────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│  🐔 LAYER 2: MAIN AGENT LAYER  ◄─── YOU ARE HERE   │
│  Claude Code - orchestration, decision-making       │
└─────────────────────────┬───────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│  🔀 LAYER 3: DELEGATION LAYER                       │
│  🦴 Slash Commands, 📚 Skills - workflow definition │
└─────────────────────────────────────────────────────┘

---

<div align="center">

← 🙋‍♀️ User Layer ━━━━━━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━ 🔀 Delegation Layer →

</div>