Buenas prácticas · Revisión

Buenas prácticas para una puerta de revisión humana

La pantalla de revisión es solo la interfaz; el control real está en que el agente sepa qué versión se decidió, qué permiso obtuvo y que se detenga en cualquier otro caso.

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

Formula la autorización

Especifica acción bloqueada, alcance, evidencia, riesgo, reversión, decisor, ventana de espera y escalado.

Mantén estable la revisión oficial

El contenido nuevo es candidato y no sobrescribe en silencio la versión que consulta el público.

ow publish ./plan.mdw --update <document_id> --review --no-open --timeout 900

Falla cerrado

Una petición de cambios requiere reenviar; rechazo, timeout o error conservan el bloqueo y el estado vigente.

Guarda evidencia de la decisión

Registra la versión fija aprobada junto con la ejecución. Un canónico común no hace que otra candidata herede permiso.

Preguntas

Preguntas frecuentes

¿Puede el agente interpretar silencio como aprobación?

No. Ausencia de decisión, timeout y error son no aprobación.

¿Incluso un cambio pequeño necesita otra revisión?

Si cambia alcance, riesgo, acción, evidencia o autorización, sí; una corrección puramente visual puede seguir reglas ya acordadas.

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.