---
title: "🐔 Layer 2: Main Agent Layer"
description: "<div align=\"center\">"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/02-main-agent-layer
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T10:58:42.779Z
license: CC-BY-4.0
attribution: "🐔 Layer 2: Main Agent Layer — Claudary (https://claudary.paisolsolutions.com/skills/02-main-agent-layer)"
---

# 🐔 Layer 2: Main Agent Layer
<div align="center">

## Overview

<div align="center">

[🏠 Home](../../README.md) › [🔧 Implementation](../README.md) › [🏛️ Architecture](./) › **🐔 Layer 2: Main Agent**

[← 🙋‍♀️ User Layer](01-user-layer.md) ━━━━━━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━ [🔀 Delegation Layer →](03-delegation-layer.md)

</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

| Responsibility | Description |
|----------------|-------------|
| **Intent Recognition** | Understand what user wants |
| **Pattern Selection** | Choose appropriate execution pattern |
| **Task Delegation** | Spawn 🐦 subagents or use 🔧🔌💁‍♀️ tools |
| **Result Synthesis** | Combine results into coherent response |

---

## 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

```mermaid
%%{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

```mermaid
%%{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

| Scenario | Pattern Selected |
|----------|------------------|
| Single simple task | Direct Execution |
| Independent tasks | 🚂 Parallel Subagents |
| Dependent tasks | Sequential Chain |
| High-risk changes | 🧙 Wizard Confirmation |

### 3. Task Delegation

```python
# 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](01-user-layer.md) ━━━━━━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━ [🔀 Delegation Layer →](03-delegation-layer.md)

</div>

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/02-main-agent-layer) · https://claudary.paisolsolutions.com