Saltar al contenido principal

3. Context phase

Agentes, Reglas y Skills: el sistema operativo del proyecto de IA.

"La IA no entiende lo que sabes. Entiende lo que le dices. Y la distancia entre ambas cosas es donde se pierden la mayoría de los proyectos."


Qué es: La disciplina de traducir la comprensión humana producida en las Fases 1 y 2 a un sistema que la IA pueda procesar. No se trata de escribir prompts ni de resumir lo que el equipo sabe. Se trata de diseñar un sistema operativo compuesto por tres elementos inseparables: Agentes que orquestan y ejecutan, Reglas que gobiernan y restringen, y Skills que definen el trabajo concreto. Juntos, estos tres elementos son el contexto.

Quién participa: El Context Engineer, el arquitecto del sistema de Agentes, Reglas y Skills. No es un prompt engineer. No es un redactor técnico. Es un diseñador que trabaja simultáneamente en tres dimensiones: definir quién hace qué (Agentes), qué está permitido y qué no (Reglas), y qué trabajo concreto hay que hacer (Skills).

Qué preguntas se responden: ¿Cómo traducimos el Problem Statement y el Solution Brief a algo que la IA pueda ejecutar con precisión? ¿Qué roles necesita la IA? ¿Qué reglas son innegociables? ¿Cómo descomponemos la solución en unidades de trabajo autocontenidas? ¿Cómo aseguramos que nada se pierde en la traducción?

Qué produce: Un sistema de contexto completo: un project-context.md con las Reglas que gobiernan todo, definiciones de Agentes con identidad, responsabilidades y límites, un PRD, un Architecture Document y Story Files que son los Skills que cada Agente ejecutará. Además de un Decision Log que registra cada evolución.

Cuándo está completa: Cuando los outputs producidos por los Agentes ejecutando Skills bajo las Reglas son reconocidos por los stakeholders de las Fases 1 y 2 como expresiones fieles del Problem Statement y el Solution Brief. No cuando los documentos se ven bien. Cuando los resultados son correctos.

Principio #04: Context Engineering no es documentación

Context Engineering es diseño de sistemas. No produces documentos, produces un sistema operativo que la IA ejecutará. La diferencia entre un buen prompt y un buen sistema de contexto es la misma que entre dar una instrucción y construir una organización. Las instrucciones se olvidan. Los sistemas operan.