Sub-Agentes Especializados

El problema: Un solo Claude maneja todo = contexto saturado + falta de especializacion

La solucion: Sub-agentes especializados con contextos aislados

El resultado: Workflows complejos sin contaminar contexto, cada agente experto en su area

Que Son los Sub-Agentes

Sub-Agentes son asistentes de IA especializados con:

• Sus propias instrucciones
• Ventanas de contexto separadas
• Permisos especificos para herramientas

Por ejemplo, podes configurar distintos sub-agentes para:

• Revisar el codigo
• Testear el codigo
• Actualizar la documentacion

Arquitectura de Sub-Agentes

Tu ↔ Main Claude (coordinator)
    ├── Code Reviewer (quality specialist)
    ├── Test Engineer (testing specialist)
    └── Documentation Writer (technical writing specialist)

Mientras tu Claude principal construye la funcionalidad, va a ir manejando sub-agentes basandose en el analisis del contexto.

Por Que Usar Sub-Agentes

Cada sub-agente mantiene su propia historia de conversacion y contexto. Esto significa que:

• El chat principal no se llena con el contexto del sub-agente
• Cada agente esta especializado en su tarea
• Podes limitar el acceso a ciertas herramientas

Configurar un Sub-Agente

Configurar un sub-agente es facil - Claude lo hace por vos:

/agents

Segui las instrucciones y decile a Claude que tipo de sub-agente queres. Van a aparecer en una carpeta nueva como archivos de markdown.

Anatomia de un Sub-Agente

Los archivos de sub-agente los podes editar. Aca un ejemplo de un code reviewer:

---
name: code-reviewer
description: Comprehensive code quality and maintainability analysis
tools: read, grep, diff, lint_runner
---
 
You are an expert code reviewer:
 
## Review Priorities (in order):
 
1. **Logic errors and bugs** that could cause system failures
2. **Security vulnerabilities** and data protection issues
3. **Performance problems** that impact user experience
4. **Maintainability issues** that increase technical debt
5. **Code style and consistency** with project standards
 
## Review Process:
 
- Analyze code for business logic correctness
- Check error handling and edge case coverage
- Verify proper input validation and sanitization
- Assess impact on existing functionality
- Evaluate test coverage and quality
 
IMPORTANT: Only report significant issues that require action.
Provide specific, actionable improvement suggestions.

Patron de Uso Recomendado

Cuando termines de trabajar en una funcionalidad:

1. En lugar de correr los tests en el mismo chat, delega a un sub-agente
2. Van a hacer su trabajo
3. Mandan los resultados de vuelta al chat principal
4. Tu ventana de contexto no se lleno

Patrones de Sub-Agentes que Uso

Pattern 1: Frontend/Backend Split

Agent 1: Build entire frontend with mocked data
Agent 2: Implement backend API with database
Agent 3: Integration testing and refinement

Pattern 2: The 3 Amigos (Para Calidad)

Agent 1 (Business): Requirements and acceptance criteria
Agent 2 (Developer): Implementation
Agent 3 (Tester): Comprehensive test coverage

Pattern 3: 7-Parallel-Task Method

Para features complejas:

Main_Task: "Build complete checkout feature"
Sub_Agents:
  1. Frontend_Components: React checkout flow
  2. Backend_API: Payment processing endpoints
  3. Database_Schema: Order and payment tables
  4. Testing_Suite: Unit and integration tests
  5. Documentation: API and user guides
  6. DevOps_Config: CI/CD pipelines
  7. Performance: Caching and optimization

Best Practices para Sub-Agentes

Manejo de Contexto

DO:

• Reset context cada 10-15 operaciones
• Mantene contextos separados por agente
• Limpia chat history agresivamente

DON'T:

• Dejes que agentes vean codigo innecesario
• Mezcles concerns entre agentes
• Mantengas historiales de conversacion largos

Diseno de Interfaces

Define contratos ANTES de spawnear agentes:

// Define contracts BEFORE spawning agents
interface UserAuthContract {
  login(credentials: LoginRequest): Promise<AuthResponse>
  logout(): Promise<void>
  refreshToken(): Promise<TokenResponse>
}

Boundaries Estrictos

# Good: Clear separation
Agent 1: Everything in src/frontend/
Agent 2: Everything in src/backend/
 
# Bad: Overlapping concerns
Agent 1: Some frontend, some API
Agent 2: Some API, some database

Troubleshooting Sub-Agentes

Issue: Context Pollution

Sintomas: Agentes referencian codigo que no deberian conocer

Solucion:

# Use strict file includes
Agent prompt: "ONLY work with files in src/components/auth/"

Issue: Integration Conflicts

Sintomas: Componentes no funcionan juntos

Solucion:

1. Define interfaces FIRST
2. Review with all agents
3. Then implement

Issue: Overlapping Work

Sintomas: Multiples agentes editando los mismos archivos

Solucion:

# Clear file ownership
Agent 1: src/frontend/**/* (exclusive)
Agent 2: src/backend/**/* (exclusive)
Agent 3: src/shared/**/* (exclusive)

Siguiente Paso

Ahora que sabes usar sub-agentes, vamos a ver como conectar Claude con herramientas externas usando MCPs.