Desarrollo basado en especificaciones

Wiki Español

El desarrollo basado en especificaciones es un enfoque en el que definiciones explícitas de productos y flujos de trabajo guían la implementación, documentación, revisión y verificación.


Definición

En este enfoque, una especificación no es sólo un documento inicial de planificación. Actúa como referencia permanente para:

  • propósito del producto
  • límites del alcance
  • comportamiento requerido
  • criterios de aceptación
  • revisar los estándares

Por qué es importante el trabajo asistido por IA

La IA aumenta la velocidad de entrega, pero también puede aumentar la desviación del producto cuando la intención es vaga.

El desarrollo basado en especificaciones ayuda a brindar a los equipos una fuente estable de verdad que se puede revisar, actualizar y utilizar para evaluar los resultados generados.

Capas típicas

Las capas comunes en un sistema basado en especificaciones incluyen:

  • especificación del producto
  • guía de implementación
  • documentación del estado actual
  • comportamiento de demostración o aplicación
  • reglas y pruebas de validación
  • Aplicación de CI/CD

Modo de falla común

Un modo de falla común es permitir que el artefacto más visible se convierta en la fuente predeterminada de verdad.

Ejemplos:

  • el último mensaje
  • el prototipo actual
  • el atajo de implementación actual
  • una página de documentación obsoleta

El desarrollo basado en especificaciones reduce ese riesgo al hacer explícita la cadena de autoridad prevista.

Let Books contexto

En Let Books, el desarrollo basado en especificaciones está respaldado por:

  • AGENTS.md
  • AGENTS-Implementation.md
  • README.md
  • docs/Development.md
  • docs/Deployment.md