SDD · Spec-Driven Development

El framework que hace que los agentes de código sigan la especificación.

Planificar antes de programar se volvió el estándar del mercado. Lo que ninguna herramienta entrega es lo que viene después del plan: verificación mecánica de que el proceso se siguió — contratos firmados por story, sensores ejecutables y evidencia en cada afirmación.

ENTREGADO COMO KIT .SDD/ DENTRO DE LOS DOS PRODUCTOS — LAUDO Y CREAR SPEC

stories/stories ejecutables con criterios de aceptación y contrato
specs/source-report/la evidencia del diagnóstico, transcrita
sensors.yamlsensores como dato: comando, criterio, bloqueante
tools/código Python (stdlib pura) que impone la gobernanza
hooks/autoridad como mecanismo: quien implementa no aprueba
canon.lockcanon de calidad fijado por versión + hash
MANIFEST.sha256 · [email protected] · 231 archivos python3 · cero dependencias
27roles con límites impuestos
17dimensiones de doctrina
291reglas SAST en el rulepack
40mutantes probando los sensores
24/26artículos con enforcement mapeado
12/12calibración ciega del juez de deriva
§ 01

Por qué ahora

Tres fuerzas convergieron entre 2025 y 2026 — y convirtieron la especificación gobernada de buena práctica en requisito.

01

Generar código se volvió barato. Generar el código correcto, no.

Cuando una funcionalidad cuesta minutos de agente, el cuello de botella migra del teclado a la intención. Describir vagamente y aceptar lo que venga produce código plausible que se aleja de la intención y envejece mal.

02

Los agentes necesitan memoria de proceso.

Un agente que abre un repositorio necesita saber qué ya se decidió, qué está prohibido y cómo se prueba que algo está listo. Sin eso, cada sesión reinventa el proyecto.

03

La auditabilidad se volvió requisito de negocio.

Código escrito por IA en producción exige un rastro: de dónde vino cada cambio, qué evidencia lo sustentaba, quién lo aprobó. El SDD es la infraestructura de ese rastro.

§ 02

No es texto — es un harness con código adentro

Dentro del kit viaja código Python (stdlib pura — corre en cualquier máquina con python3) que convierte la gobernanza de recomendación en mecanismo.

sdd_check

18 reglas de integridad sobre el propio .sdd — story sin sección obligatoria, contrato excedido, afirmación presumida sin rastreo de validación. Un kit nuevo abre 100% verde.

hooks

El hook BLOQUEA a quien implementó de marcar como listo o llenar su propia evidencia de QA. No es "el agente debería" — es "el agente no puede".

sensors.yaml

El registry de sensores es dato ejecutable: cada uno con comando, criterio y bandera bloqueante. QA no aprueba una story sin exit 0.

status_gen

El estado del proyecto se GENERA de los frontmatters de las stories — y la verificación acusa la edición manual.

canon.lock

El canon de calidad llega fijado por versión y hash, con verificación de cadena completa. Actualizar exige confirmación humana.

sensor_mutation

40 saboteadores, uno por regla de sensor — prueba mecánica de que cada sensor mira de verdad, no pasa por vacuidad.

spec_drift

El único juez no-determinístico (deriva spec×código) está cercado: rúbrica explícita, calibración ciega — sin calibración válida, sin veredicto.

import / export

Conversores bidireccionales Spec Kit / OpenSpec / Kiro, con pérdida documentada en cada archivo convertido. Entrada y salida sin encierro.

+ una Constitution de 25+1 artículos con enforcement mapeado en 24/26 — cada artículo señala el mecanismo que lo impone; los 2 sin mecanismo están marcados como decisión registrada, no como olvido.

§ 03

El comparativo, con honestidad

En las dos primeras filas el mercado empató — todos escriben especificaciones. De la línea gruesa hacia abajo, estamos solos.

CapacidadSpec KitKiroOpenSpecBMADTesslArchGenerator
Especificación antes del código
Roles multi-agente● 27
Autoridad impuesta por mecanismo (hooks)
Contratos de implementación firmados
Sensores ejecutables con registry en datos
Evidencia graduada por afirmación [A]/[P]/[Q]
Proceso que se verifica a sí mismo (mutantes)● 40
Canon versionado con hash● 17
Especificación nacida del diagnóstico del código real
Interoperabilidad bidireccional entre formatos
Open-source / comunidad

● SÍ · ◐ PARCIAL · — NO

La última fila es debilidad honesta: ellos tienen distribución y comunidad; nosotros tenemos profundidad — y hablamos con sus herramientas en las dos direcciones.

§ 04

El kit nace de prueba, no de prompt

Todo competidor parte de una descripción en lenguaje natural. Nuestro kit nace de un diagnóstico del repositorio real — validado en producción en un repositorio público.

LAUDO DE SEGURIDAD → KIT REMEDIATION CASO REAL · REPO PÚBLICO
16

stories ejecutables — críticos con cláusula de hotfix y el guardrail que impide que el agente refactorice de paso

38

detalles de hallazgo con la evidencia del laudo transcrita, advisory por advisory

sca ✓

sensor de dependencias EJECUTABLE de fábrica — generado de los lockfiles reales del repositorio

[P]→?

hallazgos con evidencia presumida se vuelven preguntas: validar antes de corregir

El equipo del cliente — o el agente de código del cliente — abre el kit, corre el bootstrap y tiene orden de ataque, evidencia y criterio de listo. Sin una reunión de planificación.

§ 05

Tres situaciones reales

"Heredé un sistema legado con decenas de vulnerabilidades y un equipo junior."

Laudo → kit de remediación: stories priorizadas con hotfix primero, evidencia transcrita, gate de dependencias listo — y la cláusula que impide que el junior (o el agente) refactorice de paso.

"La auditoría preguntó cómo gobernamos el código generado por IA."

Rastro completo por construcción: contrato firmado → evidencia citable → sensor verde → aprobación independiente impuesta por hook. Ninguna otra herramienta produce ese rastro.

"El consultor entregó el diagnóstico y se fue — ¿y ahora?"

El laudo señala, el kit ejecuta: la distancia entre el PDF y el backlog ejecutable es un clic. Una categoría que no existe entre los competidores — ninguno tiene motor de diagnóstico del cual partir.

Mientras el mercado compite por quién escribe la mejor especificación antes del código, ArchGenerator entrega la única que llega cargada de evidencia del código real, con un proceso que se verifica solo — y que además habla con las herramientas de los competidores en las dos direcciones.
§ 06

El canon es público

La doctrina de calidad que lleva el kit no es caja negra: el registry sdd-canon es público, versionado, con hash por archivo y licencia declarada en cada regla.

sdd-canon 0.3.0

17 dimensiones ancladas en estándares públicos (WCAG, CWE Top 25, OWASP, Well-Architected) + rulepack SAST de 291 reglas de 8 fuentes permisivas.

import / export

Quien ya usa Spec Kit, OpenSpec o Kiro entra y sale con pérdida declarada — sin encierro.

--yes

Actualizar el canon en el kit exige confirmación humana — un agente nunca pasa solo.

Mira el kit nacer de tu propio código.

Un laudo de tu repositorio se convierte en un kit ejecutable — con las stories, los sensores y la evidencia de tu sistema, no de un ejemplo.

Agendar demostración