Kodavio

Referencia

Seguridad y confirmaciones

Seguridad y confirmaciones

El flujo seguro es: leer, proponer, previsualizar, confirmar y escribir.

Kodavio esta disenado para que Codex pueda trabajar con autonomia, pero con barandillas claras. El objetivo es reducir errores humanos repetitivos sin perder aprobacion en las decisiones que pueden romper una pagina, borrar datos o cambiar el comportamiento del sitio.

Modos principales

ModoSignificadoCuando usarlo
dry_run=truePrevisualiza sin guardar cambios.Siempre al empezar una tarea nueva o delicada.
confirm_create=trueAutoriza crear una pagina, template o componente.Cuando quieres un borrador real.
confirm_write=trueAutoriza escribir contenido o patrones.Cuando el objetivo exacto esta claro.
confirm_destructive=trueAutoriza una accion destructiva.Solo despues de backup y aprobacion explicita.

Niveles de riesgo

RiesgoQue permiteEjemplos
readLeer estado o diagnosticos.Listar plugins, leer pagina, ver tokens, health check.
managed_writeCrear o modificar con contrato controlado.Crear pagina draft, actualizar patron, activar plugin.
elevated_writeCambios operativos sensibles.Instalar plugins, actualizar plugins, escribir mu-plugins o editar PHP en plugins/themes.
destructiveBorrar, limpiar o sustituir datos.Borrar plugin, limpiar metadata de builder, rollback destructivo.

Las habilidades elevadas y destructivas deben activarse solo cuando realmente las necesites. El hecho de que Codex pueda pedirlas no significa que deban estar siempre disponibles.

Permisos sensibles

Kodavio separa los permisos de mayor riesgo para que no tengas que abrir todo el panel administrativo a la vez:

PermisoPara que sirveRecomendacion
Editar PHP avanzadoCrear, parchear o restaurar archivos PHP permitidos en plugins/themes o sandbox.Activarlo solo durante la tarea concreta.
Editar mu-pluginsCrear o modificar archivos que cargan siempre en WordPress.Usarlo con backup y revision del resultado.
Instalar y actualizar pluginsCambiar el stack del sitio.Probar antes en staging si afecta al frontend.
Borrados y restauracionesEliminar, desinstalar, limpiar o revertir.Requiere confirmacion explicita y plan de rollback.

Estos permisos pueden convivir con modulos activos de lectura o builder. Tener un modulo detectado no significa autorizar automaticamente una operacion sensible.

Que debe devolver una operacion segura

Para una escritura real, pide que Codex te devuelva:

  • success: si la operacion fue aceptada y completada.
  • dry_run: si no se guardo nada.
  • changed: si hubo cambios reales.
  • summary: resumen legible.
  • warnings: riesgos o partes pendientes.
  • audit: ability, usuario, objeto afectado y fecha cuando aplique.
  • backups creados o ruta segura de restauracion si la operacion lo requiere.

Si la respuesta dice "hecho" pero no incluye evidencia, pide verificacion.

Buenas practicas

  • No publiques automaticamente paginas generadas.
  • No modifiques paginas publicadas sin crear copia o borrador.
  • No actives herramientas destructivas si no las necesitas.
  • No pegues secretos en prompts.
  • Pide siempre evidencia o resumen de cambios.
  • Revisa visualmente las paginas antes de publicar.
  • En conversiones, conserva origen y destino hasta terminar QA.
  • En formularios, revisa destinatarios, acciones, validaciones y mensajes.
  • En ecommerce, revisa impacto comercial antes de precios o stock.

Produccion

En produccion, cualquier escritura real deberia requerir aprobacion humana. Para pruebas, usa staging o borradores.

Redaccion de secretos

No pegues passwords, licencias, tokens API ni claves privadas en prompts. Las habilidades de settings soportados deben redactar secretos al leer, y no deberian devolver valores sensibles completos.

Si necesitas configurar una clave, lo mas seguro es:

  1. Ponerla tu manualmente en el admin del plugin correspondiente.
  2. Pedir a Codex que verifique solo si el campo esta configurado.
  3. No pedir nunca que repita el secreto en la respuesta.

Backups y rollback

Para cambios con riesgo alto pide:

  • backup antes de escribir;
  • ID de backup o referencia;
  • plan de rollback;
  • dry_run de rollback si existe;
  • confirmacion destructiva solo al ejecutar.

En builders, rollback y limpieza son pasos separados. Primero confirma que el borrador nuevo funciona; despues decide si limpiar datos antiguos.

Previous
SDK custom abilities