Antonio Herrera.
◎Guía · 13 fases

SDD Lifecycle con OpenSpec

Ciclo de vida completo de software gobernado por especificación: las 13 fases del Spec-Driven Development, de la historia de usuario al archivo del cambio, con quality gates y comandos OpenSpec.

Por Antonio Herrera Publicada en junio 2026 28 min en total
Empezar: Fase 0 →
1/14
13
Fases del ciclo
11
Quality gates
22
Pasos prácticos
Ciclo SDD con OpenSpec · 13 fases · 13 quality gatesPasa el ratón por una fase para ver su resumen
Preparar y especificarFases 0–4 · la spec manda
0PrepararProject Ready 1HistoriaHistoria Clara 2SpecSpec Ready 3ContextoContext Ready 4TareasImplementation Controlled
Construir y validarFases 5–7 · contrato, tests y revisión
5Contrato APIAPI Governance Ready 6TestsQuality Ready 7Pull RequestHuman Review
Integrar y desplegarFases 8–10 · pipeline y entornos
8CI/CDCI/CD Ready 9QA / UATQA / UAT Ready 10Go-liveProduction Ready
Operar y cerrarFases 11–12
11ObservarOperated 12ArchivoSpec Archived
0
Fase 0 · Preparación inicial del proyecto

Inicializar OpenSpec y crear la estructura base de gobierno técnico

◆ Gate 0 — Project Ready
Abrir fase →
Guía completa · Paso a paso
  1. 1
    Crear historia de usuarioDefinir necesidad de negocio y criterios de aceptación
  2. 2
    Crear propuesta OpenSpec/opsx:propose "descripción del cambio"
  3. 3
    Revisar proposal.mdValidar problema, objetivo, alcance, fuera de alcance y riesgos
  4. 4
    Revisar design.mdValidar enfoque técnico, arquitectura, impacto API, datos y seguridad
  5. 5
    Revisar spec.mdValidar requisitos y escenarios verificables
  6. 6
    Revisar tasks.mdAsegurar trabajo dividido en tareas pequeñas y comprobables
  7. 7
    Validar OpenSpecopenspec validate --strict
  8. 8
    Definir o actualizar OpenAPICrear el contrato técnico de la API — contract-first
  9. 9
    Validar contrato APIspectral lint openapi.yaml
  10. 10
    Publicar en API ManagerConfigurar catálogo, seguridad, versionado, políticas y documentación
  11. 11
    Implementar con agente IA/opsx:apply [change-id]
  12. 12
    Ejecutar tests localesmvn test · npm test · npx playwright test
  13. 13
    Validar calidadLint, SonarQube, security scan, contract tests
  14. 14
    Crear Pull RequestVincular historia, spec, contrato, tests y evidencias
  15. 15
    Revisión humanaValidar intención, alcance, calidad y seguridad
  16. 16
    Pipeline CI/CDEjecutar validaciones automáticas
  17. 17
    Despliegue a QA / UATProbar funcionalidad en entorno controlado
  18. 18
    Validación funcionalQA / PO validan criterios de aceptación
  19. 19
    Despliegue a producciónPromover versión con control de rollback
  20. 20
    MonitorizaciónLogs, métricas, trazas, errores y consumo API
  21. 21
    Archivo del cambio/opsx:archive · openspec archive <id> --yes
  22. 22
    Cierre de historiaSpec viva actualizada e historia cerrada en el tracker
Mapa mental por bloques
Bloque 1
Negocio
  • Historia de usuario
  • Criterios de aceptación
  • Alcance funcional
→ Necesidad clara
Bloque 2
Especificación
  • /opsx:propose
  • proposal.md · design.md
  • spec.md · tasks.md
→ Cambio documentado
Bloque 3
Gobierno técnico
  • OpenAPI · API Manager
  • Seguridad · Versionado
  • Políticas
→ API gobernada
Bloque 4
Implementación
  • /opsx:apply
  • Código · Tests
  • Tasks actualizadas
→ Código contra spec
Bloque 5
Validación
  • Unit · Integration · E2E
  • Contract · Security
  • openspec validate
→ Evidencia automática
Bloque 6
Revisión humana
  • Pull Request
  • Aprobación técnica
  • Aprobación funcional
→ Control de intención
Bloque 7
Despliegue
  • CI/CD · QA · UAT
  • Producción · Rollback
→ Entrega controlada
Bloque 8
Operación & Archivo
  • Observabilidad · Analytics
  • /opsx:archive
→ Conocimiento vivo
Tabla rápida de comandos
MomentoComando
Instalar OpenSpecnpm install -g @fission-ai/openspec@latest
Inicializar proyectoopenspec init
Ver estado / listadosopenspec list
Ver specsopenspec list --specs
Crear propuesta/opsx:propose "descripción"
Explorar antes de proponer/opsx:explore "análisis"
Validar specopenspec validate
Validar estrictoopenspec validate --strict
Implementar cambio/opsx:apply <change-id>
Sincronizar specs/opsx:sync
Verificar (si disponible)/opsx:verify
Archivar con agente/opsx:archive <change-id>
Archivar con CLIopenspec archive <change-id> --yes
Actualizar skills / configopenspec update
Configurar perfilopenspec config profile

Contenido de la guía

0
Preparación inicial del proyectoInicializar OpenSpec y crear la estructura base de gobierno técnico
 1
Historia de usuarioPunto de partida del ciclo real · Definición de necesidad y criterios verificables
 2
Definición de la especificaciónPrimera capa formal del ciclo · De la intención a la spec verificable
 3
Contexto, skills, MCPs y convencionesLa diferencia entre "prompting" y "engineering" · Contexto real del proyecto al agente
 4
Tareas atómicasDescomposición del trabajo en unidades pequeñas, ejecutables y verificables…
 5
Contrato API y API ManagerContract-first · OpenAPI antes que código · Gobierno de la exposición
 6
Validación integrada · TestsLos tests nacen de la spec, no al final · QA entra desde el diseño
 7
Pull Request y revisión humanaLa IA acelera, pero no sustituye el criterio · Tú validas la intención, no solo el output
 8
CI/CD y quality gatesEl pipeline valida automáticamente spec, contrato, código, tests, seguridad y build
 9
Despliegue a integración / QA / UATDel PR aprobado al entorno controlado · Validación funcional antes de producción
 10
Despliegue a producciónPromoción controlada con rollback definido desde el primer momento
 11
Observabilidad y operaciónLa fase que se olvida · Monitorizar si la funcionalidad realmente funciona bien
 12
Archivo y sincronización de OpenSpecCierre del ciclo · La spec temporal pasa a ser documentación viva del sistema

Profundiza

Guía

Capa 3A del Modelo de Gobierno IA

Dónde encaja SDD dentro del gobierno global de agentes IA.
Hablemos →