Constitución del proyecto
La constitución resuelve un problema distinto del de la spec —que dice qué se construye— y del de los boundaries —que dicen qué puede hacer el agente—. La constitución dice en qué proyecto estamos y con qué reglas se trabaja en él. En la primera edición del mapa de SDD era media frase; hoy es el primer paso del método en las implementaciones de referencia y se enseña como primera competencia del área.
El problema de fondo que resuelve es la falta de memoria del agente. Cada sesión empieza de cero y, sin un documento que fije el contexto, las decisiones estructurales se vuelven a tomar en cada conversación, con resultados distintos. La constitución es lo que reduce la «deuda cognitiva»: el esfuerzo de volver a explicar lo mismo cada vez.
Qué contiene
Los equipos de Thoughtworks que trabajan con SDD sobre bases de código existentes han documentado qué contiene una constitución que funciona de verdad:
- Alcance del proyecto. Qué es y qué no es el sistema, para que el agente no lo expanda por su cuenta.
- Contexto de dominio. El vocabulario del negocio y las reglas que un recién llegado necesitaría conocer.
- Versiones tecnológicas. Lenguajes, marcos y bibliotecas con sus versiones, para que no se introduzcan otras.
- Estándares de código. Convenciones de nomenclatura, de pruebas y de estilo.
- Estructura del repositorio. La arquitectura elegida (por ejemplo, hexagonal o por capas) y dónde va cada cosa.
A esa lista se añaden los boundaries de proyecto: las reglas generales sobre lo que el agente hace siempre, consulta antes o no hace nunca (el sistema Always / Ask First / Never).
Por qué debe ser corta
Una constitución que intenta contenerlo todo cae en la maldición de las instrucciones: pasado cierto punto, más contexto degrada la capacidad del modelo de recuperar lo importante. La regla de reparto es sencilla: lo que vale para un solo incremento va en su spec; lo que vale para todos va en la constitución. Mezclarlos engorda la constitución y desactualiza la spec. Cuando la constitución existe, además, cada spec puede ser más corta, porque no repite lo que ya está decidido.
Dónde vive y cómo se mantiene
En GitHub Spec Kit la constitución se crea con el primer comando del flujo y vive en el repositorio, versionada con el código. En el resto del ecosistema, el soporte habitual es un fichero de instrucciones para agentes en la raíz del proyecto, con AGENTS.md como el formato más extendido. Lo importante no es el nombre del fichero, sino que esté donde el agente lo lea al empezar y donde el equipo lo revise al cambiar una decisión estructural.
Se mantiene como cualquier decisión de arquitectura: cambia poco, cambia con deliberación y cada cambio se revisa, porque afecta a todo lo que se construya después. Un incremento que necesite saltarse una regla de la constitución es una señal de que la regla —o el incremento— merecen una conversación.
Error frecuente
Meter en la constitución lo que es propio de un incremento. La constitución engorda, la spec se desactualiza y el agente recibe reglas que no aplican a su tarea. Su reverso es igual de dañino: no tener constitución y confiar en la memoria de la conversación hace que cada sesión vuelva a decidir la arquitectura, y la deriva estructural aparece en semanas. Y escribirla una vez y no volver a mirarla es peor que no tenerla, porque una constitución que contradice las decisiones vigentes del equipo es a la que el agente hace caso.
Recursos
📊 Guía didáctica SDDRecursos · Scrum Manager
🏦 SDD en equipos ágilesSkill Arena · Scrum Manager
Referencias
- Böckeler, Birgitta. (2025). «Understanding Spec-Driven Development». Thoughtworks / martinfowler.com.
- GitHub. (2026). Spec Kit (documentación del proyecto).
- DeepLearning.AI. (2026). Spec-Driven Development with Coding Agents (curso).
Véase también
¿Quieres avanzar en agilidad? Puedes buscar convocatorias de cursos y exámenes o ir a tu ritmo haciéndote miembro del Club Agile. Esta membresía incluye recursos exclusivos, aulas e-learning y acceso a Skill Arena: un espacio para practicar y medir tus habilidades ágiles a tu ritmo.