Guía · Especificaciones

Entregar una especificación técnica generada por un agente

Una especificación se convierte en contrato de implementación cuando el lector puede cuestionar supuestos, comprobar límites y saber exactamente qué versión autorizó.

Actualizado 3 de agosto de 2026Guía práctica

Hazla decidible

Incluye problema, usuarios y no objetivos, evidencia actual, comportamiento propuesto, datos, permisos, fallos, migración, reversión, riesgos y autorización solicitada.

Separa hecho, propuesta y hoja de ruta

Quien revisa debe distinguir de un vistazo el sistema actual, el cambio propuesto y una posibilidad futura.

Entrega una candidata formal

Tras validar en local, publica con --review. Si piden cambios, corrige el origen y reenvía; no sustituyas la candidata con acuerdos de chat.

ow a2ui draft check ./spec
ow a2ui draft build ./spec
ow a2ui digest ./spec/document.mdw
ow publish ./spec/document.mdw --review --no-open --timeout 900

Implementa contra la revisión aprobada

En tareas y evidencias de release, enlaza la versión inmutable aprobada. Un cambio sustancial requiere una nueva candidata.

Preguntas

Preguntas frecuentes

¿La implementación debe enlazar al canónico o a la versión fija?

Al contrato de versión fija aprobado; el canónico sirve para consultar el estado oficial actual.

¿Puede un agente aprobar su propia especificación?

No. El circuito de revisión requiere una decisión humana explícita.

Usa el flujo real

Publica lo que crea tu agente.

Da a cada informe, documento o plan una página lista para sus lectores, desde la que vuelvan comentarios, decisiones y revisiones formales.