Arquitectura de Agentes

En el nivel avanzado, aprenderás a orquestar múltiples agentes, crear agentes personalizados, y optimizar la comunicación entre ellos.

Requisito: Este contenido requiere experiencia sólida con ClaudeKit. Asegúrate de completar el Nivel Intermedio primero.

Temas que Cubriremos

Orquestación de Múltiples Agentes

Coordinar varios agentes trabajando en paralelo o secuencia.

Comunicación Entre Agentes

Protocolos de comunicación y mensajería entre agentes.

Agentes Personalizados

Crear tus propios agentes especializados.

Skills Personalizadas

Desarrollar skills específicas para tu dominio.

Orquestación de Múltiples Agentes

Sequential Chaining

Los agentes se ejecutan uno tras otro, pasando información.

# Planner → Researcher → Developer → Tester
claude plan "Feature X"
claude cook "Implementar Feature X según plan"

Parallel Execution

Múltiples agentes trabajan simultáneamente.

# Research paralelo con 3 researchers
claude plan "Microservices architecture" --parallel

Agent Teams

Sesiones coordinadas con múltiples agentes.

# Equipo completo trabajando juntos
claude cook "Feature completa" --parallel --team

Comunicación Entre Agentes

File-Based Communication

Los agentes se comunican mediante archivos:

plans/
├── plan.md              # Plan creado por Planner
├── reports/
│   ├── researcher-1.md  # Research de Agent 1
│   ├── researcher-2.md  # Research de Agent 2
│   ├── developer.md     # Código generado
│   └── tester.md        # Resultados de tests

Protocolos de Mensajería

// Mensaje entre agentes
{
  "from": "planner",
  "to": "developer",
  "type": "task",
  "payload": {
    "task": "implement-auth",
    "specs": {...},
    "priority": "high"
  }
}

Agentes Personalizados

Estructura de un Agente

.claude/agents/
└── custom-agent/
    ├── config.json       # Configuración del agente
    ├── prompt.md         # System prompt
    ├── tools/           # Herramientas disponibles
    └── skills/          # Skills que puede usar

Ejemplo: Database Architect Agent

config.json

{
  "name": "database-architect",
  "role": "Diseña schemas y optimiza queries",
  "capabilities": [
    "schema-design",
    "query-optimization",
    "index-strategy",
    "migration-planning"
  ],
  "tools": ["sql-executor", "schema-validator"],
  "context_limit": 100000
}

prompt.md

# Database Architect Agent

Eres un experto en bases de datos con 15 años de experiencia.

## Tu Rol

- Diseñar schemas normalizados
- Optimizar queries lentas
- Planear estrategias de índices
- Crear migraciones seguras

## Principios

1. **Normalización** - 3NF por defecto, denormalizar solo con razón
2. **Performance** - Índices solo cuando benefician queries reales
3. **Migraciones** - Siempre backwards compatible
4. **Seguridad** - Nunca exponer datos sensibles

## Workflow

1. Analizar requisitos
2. Diseñar schema ERD
3. Crear migrations SQL
4. Definir índices
5. Documentar decisiones

Skills Personalizadas

Crear una Skill

.claude/skills/
└── my-domain/
    ├── SKILL.md
    ├── scripts/
    │   └── analyze.py
    └── templates/
        └── schema.sql

Ejemplo: PostgreSQL Expert Skill

SKILL.md

# PostgreSQL Expert

Skill especializada en PostgreSQL optimización y diseño.

## Cuándo Usar

- Diseñar schemas complejos
- Optimizar queries lentas
- Configurar índices avanzados
- Planear particionamiento

## Comandos Disponibles

- `analyze-query` - Analiza performance de query
- `suggest-indexes` - Sugiere índices basados en queries
- `design-schema` - Crea schema ERD basado en requisitos

Siguiente: Workflows Complejos

Patrones avanzados de orquestación y escalabilidad.

---

Nota: Esta sección está en desarrollo. Mientras tanto, explora los Ejemplos Prácticos para ver workflows complejos en acción.