Orquestacion Multi-Agente

GSD usa un patron de orquestador delgado + agentes especializados. El orquestador coordina, los agentes trabajan.

Arquitectura

Tu (comando)
    ↓
Orquestador (30-40% contexto)
    ├── Presenta resultados
    ├── Coordina flujo
    └── Gestiona estado
        ↓
Agentes especializados (200k contexto fresco cada uno)
    ├── Investigadores (4 paralelos)
    ├── Planificador + Verificador (loop)
    ├── Ejecutores (waves paralelas)
    └── Debug agents (bajo demanda)

Agentes por fase

Research (4 agentes paralelos)

Agente	Investiga
Stack	Versiones, compatibilidad, setup
Features	Patrones de implementacion, referentes
Arquitectura	Estructura, trade-offs, escalabilidad
Pitfalls	Problemas comunes, anti-patrones, gotchas

Todos corren en paralelo con contextos frescos. El orquestador consolida los hallazgos en RESEARCH.md.

Planning (2 agentes en loop)

Planificador → crea planes XML
    ↓
Verificador → valida contra requisitos y contexto
    ↓
¿Pasa? → Si: siguiente fase. No: vuelta al planificador.

El loop continua hasta que todos los planes pasan verificacion. Tipicamente 1-3 iteraciones.

Execution (N agentes en waves)

Wave 1: [Agente A, Agente B] → ejecutan en paralelo
                ↓ (esperan)
Wave 2: [Agente C, Agente D] → ejecutan en paralelo
                ↓ (esperan)
Wave 3: [Agente E] → ejecuta solo

Cada agente ejecutor:

1. Recibe contexto fresco con PROJECT.md + PLAN.md
2. Lee los archivos del codebase que necesita
3. Implementa la tarea
4. Ejecuta la verificacion del plan
5. Genera commit atomico
6. Escribe SUMMARY.md

Verification (agentes bajo demanda)

• Verificador: extrae deliverables y presenta al usuario
• Debug agents: se lanzan solo cuando un deliverable falla
• Fix planner: genera planes de correccion si hay fallos

Por que funciona

Frescura sobre acumulacion

En un workflow tipico con IA, despues de 20 intercambios el LLM ya esta degradado. Con GSD, cada tarea empieza con 200k tokens limpios.

Especializacion

Un agente que solo investiga arquitectura produce mejores resultados que uno que investiga todo. Cada agente tiene un scope reducido y enfocado.

Independencia

Los agentes no comparten estado en memoria. Se comunican via archivos persistidos en disco. Esto evita contaminacion cruzada.

El orquestador no ejecuta

El orquestador solo:

• Lee el estado actual
• Decide que agente lanzar
• Presenta resultados al usuario
• Actualiza STATE.md

Nunca implementa codigo ni investiga directamente.

Resumen

• Orquestador delgado (30-40% contexto) + agentes frescos (200k cada uno)
• 4 investigadores paralelos por fase
• Planificador + verificador en loop hasta que planes pasen
• Ejecutores en waves paralelas con commits atomicos
• Debug agents bajo demanda para diagnostico de fallos
• Comunicacion via archivos, no via contexto compartido

---

← Context Engineering | Indice | Siguiente: Brownfield y Gestion de Fases →