Saltar al contenido principal

3. Context phase

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

Esta es la guía operativa para ejecutar el Context Phase — la fase en la que el equipo traduce la comprensión humana en un sistema que la IA puede procesar fielmente. Mientras que la sección de metodología explica el por qué y los fundamentos conceptuales (qué son los Agentes, las Reglas y los Skills y por qué importan), esta guía cubre el cómo: el proceso concreto a seguir, los artefactos a producir, los criterios a cumplir antes de avanzar y los patrones de fallo a vigilar.

5
Pasos estructurados
De Reglas a Validación
6
Artefactos
Transferidos a Fase 4
9
Criterios de Gate Review
Todos deben cumplirse para avanzar

El flujo de Context Phase​

Context Phase traduce la comprensión humana en un sistema que la IA puede procesar fielmente, a través de cinco pasos en secuencia estricta. Las Reglas van primero porque todo lo demás depende de ellas. Los Agentes se diseñan antes que los Skills porque los Skills necesitan saber quién los ejecutará. Los documentos estratégicos van antes de la descomposición porque los Skills se derivan de ellos. La validación va al final porque prueba el sistema completo, no las piezas individuales.

1. Establecer Reglas

Definir la constitución del proyecto: stack, convenciones, restricciones, límites de Agentes y protocolo ante gaps. Todas las decisiones globales.

project-context.md
1

2. Diseñar la Cadena de Agentes

Definir qué Agentes existen, qué hace cada uno y cómo se pasan el trabajo. Cada uno con identidad, responsabilidades, límites y protocolo ante gaps.

Definiciones de Agentes
2

3. Generar Documentos Estratégicos

El PM Agent produce el PRD a partir del Solution Brief. El Architect Agent produce el Architecture Document y promueve nuevas Reglas.

PRD + Architecture Document
3

4. Descomponer en Skills

El SM Agent descompone la solución en tareas autocontenidas con todo el contexto que un Agente necesita para completarlas.

Story Files
4

5. Validar a través de Outputs

Los Agentes ejecutan Skills de muestra bajo las Reglas. Los stakeholders verifican que el output sea una expresión fiel de lo acordado.

Sistema de contexto validado
5

Los seis artefactos​

Esta fase produce seis artefactos que juntos forman el sistema operativo para la Fase 4. A diferencia de las fases anteriores, aquí los artefactos los producen tanto humanos como Agentes de IA, y cada uno tiene productores y consumidores definidos dentro de la cadena.

Calidad del sistema de contexto​

Un sistema de contexto bien diseñado puntúa alto en las cinco dimensiones de calidad. Los gaps en cualquier dimensión producen outputs que parecen correctos pero no son fieles a lo que los stakeholders acordaron.

FidelidadCompletitudAutocontenciónTrazabilidadConsistencia
Sistema bien diseñado
Sistema con gaps
  • Fidelidad — Los outputs coinciden con el Problem Statement y el Solution Brief. Sin invención, sin reinterpretación.
  • Completitud — Cada Regla, Agente y Skill tiene todos los elementos obligatorios. Sin contexto implícito.
  • Autocontención — Un Agente con un Skill + project-context.md puede completar la tarea sin preguntar nada.
  • Trazabilidad — Problem Statement → Solution Brief → PRD → Reglas + Skills. Cada elemento traza hacia atrás.
  • Consistencia — Las Reglas no se contradicen entre sí. Los Skills heredan Reglas fielmente. Los Agentes respetan sus límites.

Qué cubre esta guía​

La inversión del sistema operativo

Si el Context Phase consume más tiempo que la fase de construcción, probablemente estás sobre-especificando Reglas o atomizando Skills en exceso. Si consume menos de un tercio del tiempo de construcción, hay Reglas implícitas y Skills incompletos. La proporción óptima es 30-50% del tiempo de construcción. Para un proyecto que tardará 4 semanas en construirse, invierte 1-2 semanas en Context Phase. El retorno: la construcción se convierte en la fase de menor fricción.