El secreto: tú ya sabes esto
Descubre que los 7 principios son gestión de personas escrita para quienes no deducen nada.
Qué es
Reemplace la palabra “agente” por “nuevo empleado” y relea los 7 principios: ninguno suena extraño para quien ya ha liderado a alguien. Intención describe el puesto; contexto es el onboarding; los datos son el sistema oficial; criterio son metas; autonomía es la atribución; observación es el informe; supervisión es la reunión 1:1. El informe sobre “una nueva era de la IA” les dio un nombre nuevo a prácticas antiguas.
Por qué aprender
Quien cree que gestionar agentes exige aprenderlo todo desde cero se bloquea antes de empezar. Entender que ya sabes buena parte del método quita el miedo y acelera la primera delegación. Y te da un criterio simple: si no delegarías así a una persona, no delegues así a una IA.
Conceptos clave
- Puesto: intención, para qué existe la vacante.
- Onboarding: contexto, lo que se enseña el 1.er día.
- Atribución: autonomía, “hasta R$ 500 tú decides”.
- 1:1: supervisión, revisar, corregir, promover o no.
Qué es
Un nuevo empleado deduce muchas cosas: observa a los colegas, percibe el tono de la empresa, pregunta en el pasillo. El agente no hace nada de eso; trabaja solo con lo que está escrito en la instrucción y en los datos a los que tiene acceso. Todo lo que una persona deduciría tiene que convertirse en texto: el tono, la fuente que vale, qué hacer cuando falta información, cuándo parar.
Por qué aprender
La mayor parte de los errores de los agentes proviene de lo que “era obvio” para quien delegó. Con una persona, la falta de claridad cuesta caro si se hace despacio; con un agente, cuesta en el momento y a escala. Enumerar lo implícito es la forma más barata de evitar ese error.
Conceptos clave
- Tono: cómo hablar con el cliente, formal o cercano.
- Fuente: qué planilla o sistema vale, y cuál no.
- Si falta: qué hacer cuando el dato no existe.
- Parar: en qué situación te llama.
Qué es
Agentes de código, como Claude Code y Codex, son programas de IA que trabajan dentro de un repositorio, la carpeta de un proyecto con todo su historial. Quien usa estos agentes practica los 7 principios todos los días: el modo plano (el agente propone antes de tocar), el CLAUDE.md o AGENTS.md (archivo con las reglas del proyecto), el repositorio como fuente, tests (verificaciones automáticas), permisos, registro de falhas y revisión.
Por qué aprender
Esto demuestra que el método no es teoría de escenario: ya funciona en producción, en manos de miles de personas. Incluso quien no programa gana si copia estas prácticas en otras áreas. Y quien programa gana un vocabulario para explicar su propia rutina a gestores.
Conceptos clave
- Modo plano: intención, combinar antes de ejecutar.
- CLAUDE.md: contexto, las reglas de la casa en un archivo.
- Tests: criterio de listo; listo es lo que pasa la verificación.
- Revisión: supervisión; el humano aprueba lo irreversible.
Qué es
En Claude Code, el modo de permiso define lo que el agente puede hacer sin preguntar. En plan solo lee y propone; en default pide aprobación en cada edición o comando; en acceptEdits edita archivos solo, pero los comandos siguen pidiendo; en bypassPermissions libera todo. Es la misma escalera de autonomía N0 a N4, solo que con un botón en lugar de una conversación.
Por qué aprender
Elegir el modo “por las malas” es el error más común de quien empieza con agentes de código. Con la escalera, la elección pasa a tener reglas: el nivel viene de la acción y los riesgos, no de la prisa. Y queda claro qué tiene que pasar para subir de escalón.
Conceptos clave
- N0 y N1: plan, solo lee y propone.
- N2: default, aprueba cada edición y comando.
- N3: acceptEdits, edita solo; los comandos piden.
- N4: solo con hooks y entorno aislado.
Qué es
Tres piezas convierten los principios en una configuración real. El archivo de instrucción (CLAUDE.md para el Claude Code, AGENTS.md para Codex y otros) queda en la raíz del proyecto y se lee en toda sesión. Los tests son comandos que verifican automáticamente si el trabajo está bien. Los hooks son disparadores que se ejecutan antes de una acción y pueden bloquearla; las reglas allow y deny en las configuraciones habilitan o prohíben acciones.
Por qué aprender
Escribir “no hagas deploy” en la conversación no basta: la conversación termina y la regla desaparece. En el archivo de instrucción vale cada vez; como regla deny o hook vale incluso si el agente se olvida. Es la diferencia entre pedir y garantizar.
Conceptos clave
- CLAUDE.md: reglas de la casa leídas en toda sesión.
- Tests: criterio de listo que no depende de la opinión.
- Deny: acción prohibida por los permisos.
- Hook: un bloqueo que evita lo irreversible antes de que ocurra.
Qué es
Las 7 preguntas son las mismas que siempre hizo un buen gestor. Sin intención, el agente hace con eficiencia la tarea equivocada; sin fuente de verdad, elige por sí solo la información y elige mal; sin criterio, dice “listo” y tú te das cuenta después de que no lo estaba. Y el diseño de los principios es un círculo: la supervisión alimenta de vuelta la intención, cada error se vuelve regla y cada semana limpia se vuelve un escalón de autonomía.
Por qué aprender
Culpar “a la IA” impide corregir lo que está a tu alcance: la delegación. Cuando tratas cada error como una regla que falta, el agente mejora semana a semana sin cambiar de herramienta. El círculo convierte la ficha en un proceso vivo, no en un formulario rellenado una sola vez.
Conceptos clave
- Sin intención: hace bien la tarea equivocada.
- Sin fuente: elige mal la información.
- Sin criterio: “listo” que no está listo.
- Círculo: el error observado se vuelve una regla nueva.