Qué vs por qué
No compiten: SDD dice el qué; el ADR, el por qué.
- SDD (Spec Kit, OpenSpec): spec → genera plan, tareas y código. Caduca al implementarla.
- ADR: registra la decisión y su evidencia. Append-only, perdura.
A favor del ADR: agnóstico (markdown+git, sin lock-in), auditable, ideal en código vivo.
En contra: más manual, no genera código; para una feature nueva de cero, SDD estructura mejor.
No es o uno o otro: se combinan (OpenSpec trae
spec-driven-with-adr).
Notas del ponente
Respuesta a la pregunta típica: "¿por qué esto y no spec-kit / openspec?". Clave: SDD = qué, ADR = por qué; en un proyecto vivo y libre lo que se pierde es el porqué, y markdown+git no ata a ningún motor. Remate: no es o uno o otro — se combinan (OpenSpec trae spec-driven-with-adr). Si aprietan: "spec para la feature, ADR para la coherencia entre features". Puedes usarla de reserva y saltarla si vas justo de tiempo.