Buenas prácticas · Versiones

Buenas prácticas de versionado para documentos de IA

La IA acelera los cambios y hace más fácil confundir lo actual con lo que se aprobó entonces. Versionar bien no es guardar muchas copias: es hacer explícita la promesa de cada referencia.

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

Define la identidad

Resume tema, responsable, tarea del lector y frontera de evidencia. Usa esa definición para decidir cada actualización.

Añade, no sobrescribas

Con --update avanza el canónico y conserva historial, PDF y paquete; una candidata con aprobación permanece separada.

ow publish ./artifact/document.mdw --update <document_id> --review --no-open

Da a cada URL su trabajo

Canónico para estado vivo, versión fija para decisión, auditoría o cita, PDF para adjunto y .mdw para recuperación por agentes.

Crea otra identidad cuando cambie el sentido

Cambios sustanciales de responsable, tema, audiencia, decisión o evidencia no deberían reutilizar un enlace solo por conservar atención.

Preguntas

Preguntas frecuentes

¿Un informe periódico necesita una URL distinta cada vez?

Normalmente no, si el contrato con el lector no cambia; añade revisiones.

¿Una actualización altera enlaces de versiones anteriores?

No. Una versión fija apunta a una revisión oficial inmutable.

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.