Diseña agentes de IA que inspiren confianza: nombra los modos, espera el plan y ofrece diffs de conservar o descartar

Nombra el modo antes de que el modelo hable

Cuando un agente de código con IA está a punto de tocar tu repositorio, el usuario necesita saber qué puede hacer antes de que lo haga. Los usuarios de Claude Code aprobaron aproximadamente el 93% de las solicitudes de permiso, un patrón asociado con la fatiga de aprobación. Un mapa de modos y puntos de control hace visible el límite:

• modo
• qué puede leer o escribir
• artefacto que produce
• punto de aprobación
• diff de conservar o descartar o ruta de reversión

Shape lanzó la versión 1.0.0 el 9 de octubre de 2026, y su flujo de trabajo del agente se organiza en torno a cinco modos nombrados: Code, Ask, Plan, Visual y Review. Solo funciona en Windows 10 o posterior y es compatible con x64 y ARM64. Cada modo debe indicar qué puede leer, qué puede escribir y qué no debe hacer.

Una etiqueta de estado visible, una breve descripción de lo que ese estado puede tocar y una acción deshabilitada para todo lo que esté fuera de ese estado convierten una interfaz de chat en un sistema de permisos. Si el usuario no puede distinguir si el agente está leyendo, redactando, editando o inspeccionando, la interfaz ya ha fallado. La etiqueta debe hacer evidente la autoridad actual del agente sin pedirle al usuario que la infiera por el tono, la longitud o el último mensaje.

Pausa el plan hasta que el usuario lo apruebe

Registra el plan antes de cualquier escritura. El modo Plan de Shape registra un enfoque paso a paso en un archivo .shape/plans y se pausa para la aprobación del desarrollador antes de realizar cambios en el código. El modo Plan de Claude Code es de solo lectura: investiga y redacta un enfoque, pero no modifica archivos hasta que el usuario da una aprobación explícita. ZCode solicita un resultado deseado, luego planifica, edita archivos, ejecuta comprobaciones, revisa el progreso e itera hasta alcanzar el objetivo.

Haz que el artefacto del plan sea duradero. Si el plan desaparece tras la aprobación, el usuario no puede auditar por qué el agente eligió ese camino. Una secuencia legible de pasos, los archivos o comandos que espera tocar y un botón de aprobación explícito que no hace nada hasta que se presiona mantienen el plan vivo después de que la conversación se desplace.

La trampa es un plan que suena seguro pero oculta el alcance. Si el usuario no puede ver qué archivos, comandos o llamadas de red están dentro del alcance, la aprobación se convierte en una formalidad. En la gobernanza de la IA agéntica, un mayor riesgo y una menor reversibilidad exigen una prueba más sólida antes de permitir que un agente actúe solo.

Convierte cada edición en una decisión de conservar o descartar

Muestra el diff antes de que el cambio se vuelva real. Shape presenta un diff para cada edición y deja el commit en manos del usuario. En Shape, el modo Review diagnostica el error subyacente, sugiere una reparación mínima y muestra diffs archivo por archivo en el chat. El modo Visual de Shape permite a un desarrollador hacer clic en un elemento de la interfaz en un navegador localhost integrado en la aplicación y luego escribe los cambios correspondientes en el código fuente para su aprobación.

Haz el diff lo suficientemente granular para poder descartar. Si un cambio toca un archivo de configuración, una prueba y un componente de la interfaz, muéstralos por separado. Cambios archivo por archivo, un antes y después claros y un control para conservar un cambio, descartar otro o revertir toda la edición convierten la salida del agente en decisiones que el usuario puede tomar en el orden en que importan.

Ese control importa más cuando el agente acierta en la corrección pero se equivoca en los efectos secundarios. Una vista de diff útil permite al usuario aceptar la reparación, rechazar el cambio ruidoso y mantener el estado del repositorio legible sin tener que releer toda la conversación.

Deja el commit en manos del humano

Mantén el commit fuera de las manos del agente. La actualización v2.1.200 de Claude Code, lanzada el 3 de julio de 2026, estableció Manual como la configuración de permisos predeterminada en lugar de Auto en la interfaz de línea de comandos, la extensión de VS Code, el plugin de JetBrains y la salida de ayuda. El modo Manual de Claude Code se pausa para obtener consentimiento antes de escrituras en archivos, comandos de shell o llamadas de red. ZCode requiere un paso de confirmación antes de ejecutar comandos sensibles, modificaciones de archivos o acciones de alto privilegio.

Un diff de conservar o descartar es solo la mitad de la promesa. El usuario también necesita una forma de deshacer el cambio aceptado sin buscar en el historial. Coloca el control de commit junto al diff, no detrás de un menú de ajustes. Un botón de commit que está deshabilitado hasta que el usuario ha revisado el diff, y una ruta de reversión visible después de que el cambio se aplica, convierten la decisión final en un acto deliberado y no en una ocurrencia tardía.