Context Engineering

El context engineering es lo que diferencia a GSD de simplemente “pedirle cosas a la IA”. Es la gestion deliberada de que informacion entra y sale de la ventana de contexto del LLM.

El problema del context rot

Cuando un LLM acumula contexto durante una sesion larga:

• La calidad de las respuestas baja despues del ~40% de utilizacion
• El modelo “olvida” instrucciones del inicio
• Genera codigo que contradice decisiones anteriores
• Las alucinaciones aumentan

GSD resuelve esto manteniendo el orquestador al 30-40% y delegando trabajo pesado a subagentes con contextos frescos.

Archivos estrategicos

GSD mantiene archivos especificos cargados segun la fase:

Archivo	Tamano	Carga	Proposito
PROJECT.md	Breve	Siempre	Vision, stack, decisiones
STATE.md	Breve	Siempre	Posicion actual, blockers
REQUIREMENTS.md	Medio	Bajo demanda	Requisitos v1/v2
ROADMAP.md	Medio	Bajo demanda	Fases y progreso
CONTEXT.md	Breve	Durante plan/execute	Decisiones de implementacion
RESEARCH.md	Medio	Durante plan	Hallazgos de investigacion
PLAN.md	Breve	Durante execute	Instrucciones atomicas
SUMMARY.md	Breve	Post-execute	Que se implemento

Limites de tamano

Cada archivo tiene un tamano maximo basado en umbrales de degradacion de calidad de Claude. PROJECT.md y STATE.md deben ser concisos porque se cargan siempre.

Carga selectiva vs carga total

Lo que NO hace GSD

❌ Cargar todo el codebase al inicio
❌ Acumular historial de conversacion
❌ Mantener resultados de tareas anteriores
❌ Cargar archivos "por si acaso"

Lo que SI hace

✅ Cada subagente recibe solo lo que necesita
✅ PROJECT.md + PLAN.md + archivos relevantes
✅ El orquestador solo coordina, no ejecuta
✅ Los resultados se persisten en archivos, no en contexto

STATE.md: memoria entre sesiones

STATE.md es la memoria persistente del proyecto. Cuando cierras Claude Code y vuelves a abrir, GSD lee STATE.md para saber donde quedaste:

## Current Position
Phase 3, Plan 2 executing (Wave 1 complete)

## Decisions Made
- bcrypt for password hashing (Phase 2)
- JWT in httpOnly cookie (Phase 2)
- Prisma for ORM (Phase 1)

## Blockers
- None

## Notes
- User prefers minimal UI, no animations
- Mobile responsive is Phase 4 priority

El contexto del orquestador

El orquestador principal (el que procesa tus comandos) se mantiene liviano:

Contexto del orquestador (~30-40%):
├── PROJECT.md (vision)
├── STATE.md (posicion)
├── Instrucciones GSD (skills)
└── Tu comando actual

Contexto de subagentes (fresco 200k cada uno):
├── PROJECT.md (vision)
├── PLAN.md (instrucciones de la tarea)
├── Archivos del codebase relevantes
└── Nada mas

Resumen

• Context engineering = gestion deliberada de que entra al LLM
• El orquestador se mantiene al 30-40%, subagentes reciben contexto fresco
• Archivos estrategicos con tamanos controlados y carga selectiva
• STATE.md persiste memoria entre sesiones
• Los resultados se persisten en archivos, no se acumulan en contexto
• Esto elimina el context rot que degrada la calidad en sesiones largas

---

← Quick Mode y Milestones | Indice | Siguiente: Orquestacion Multi-Agente →