SPEC-DRIVEN DEVELOPMENT
Primero el propósito. Después, el desarrollo.
Spec-Driven Development (SDD), o desarrollo guiado por especificaciones, organiza el trabajo alrededor de una descripción clara del comportamiento esperado. La especificación expresa qué resolver y por qué; el plan desarrolla cómo implementarlo.
Un flujo de trabajo con decisiones visibles
- 01
Acordar principios
Definir las reglas de arquitectura, calidad y seguridad que debe respetar el proyecto.
- 02
Especificar
Describir usuarios, alcance, requisitos y criterios de aceptación observables. Resolver las dudas que afectan al alcance.
- 03
Planificar
Elegir componentes, interfaces, datos, dependencias, pruebas y despliegue según las restricciones del proyecto.
- 04
Dividir en tareas
Preparar acciones pequeñas que relacionen cada cambio con un requisito y una forma de comprobarlo.
- 05
Implementar y verificar
Construir, ejecutar pruebas y revisar los resultados frente a la especificación. Actualizar los documentos cuando cambie una decisión.
Para qué sirve
Ayuda a hacer explícitos los acuerdos, detectar ambigüedades antes de implementar y revisar si el resultado responde a la necesidad planteada.
Cómo lo aplica este generador
SDD Generator prepara una base documental para que el equipo la revise. Parte de tus respuestas; los campos sin respuesta quedan pendientes y las decisiones técnicas deben adaptarse al proyecto.
| Documento | Para qué lo usarás |
|---|---|
| spec.md | El problema, alcance, requisitos y criterios de aceptación. |
| plan.md | La propuesta técnica, las pruebas y el despliegue. |
| tareas.md | El trabajo inicial vinculado a RF, RNF y RS. |
| ADR y análisis de riesgo | Las decisiones propuestas y los riesgos que deben evaluarse. |
| Checklists y evidencias | Las revisiones y pruebas que el equipo debe completar. |
Un ejemplo breve
Necesidad: ejecutar los respaldos sin depender de una acción manual diaria.
RF-001: el sistema debe crear un respaldo de los directorios seleccionados a la hora configurada.
Criterio: dado un origen accesible, cuando llega la hora programada, entonces se crea el respaldo y se informa su ubicación.
Plan: un script valida las rutas, crea el archivo y registra el resultado.
Tarea: escribir una prueba del caso correcto y otra del origen inválido antes de implementar el respaldo.
Después de descargar
Revisa spec.md y PENDIENTES.md, acuerda el alcance con el equipo, adapta la constitución y el plan, y completa aprobaciones, pruebas y evidencias antes de un pase a producción.