Live Spec
Un contrato determinista y legible por máquina que define qué construir, por qué es importante y cómo verificar que funciona.
Definición
Un Live Spec es un plan modular y con control de versiones que reemplaza las historias de usuario tradicionales con un contrato legible por máquina, lo suficientemente preciso para que un agente lo implemente sin preguntas aclaratorias. A diferencia de las descripciones informales de tickets, un Live Spec no deja lugar a la interpretación e incluye todo lo que un agente necesita para verificar su propio trabajo según los criterios de aceptación.
Cada Live Spec contiene tres activos mínimos:
- Contrato de Comportamiento — la descripción precisa de lo que el sistema debe hacer, incluyendo entradas, salidas, casos límite y manejo de errores.
- Constitución del Sistema — las reglas arquitectónicas, los estándares de codificación y las restricciones que la implementación debe respetar.
- Mapa de Tareas Accionable — los pasos descompuestos que un agente sigue para implementar la especificación, ordenados por dependencia.
Un Live Spec no es un documento estático. Evoluciona junto con la base de código, se almacena bajo control de versiones y se actualiza cada vez que los requisitos cambian o surgen nuevas restricciones. Esta naturaleza viva lo distingue de los documentos de requisitos tradicionales que se vuelven obsoletos después de la creación inicial.