Es gestión de personas con otro nombre
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
Objetivo: traducir una tarea tuya de “gestión de personas” a “gestión de agentes”.
Tarea: <la tarea que quieres delegar>
1. Intención (cargo): ¿para qué existe esta función? <respuesta>
2. Contexto (onboarding): ¿qué explicaría en el 1er día? <respuesta>
3. Datos (sistema oficial): ¿dónde está la información que vale? <respuesta>
4. Criterio (meta): ¿cómo es un trabajo bien hecho? <respuesta>
5. Autonomía (alcance): ¿hasta dónde decide solo? <respuesta>
6. Observación (reporte): ¿qué quiero ver y cuándo? <respuesta>
7. Supervisión (1:1): ¿cuándo reviso y corrijo? <respuesta>
Cómo verificar: si alguna línea quedó vacía, justo ahí es donde el agente va a fallar.
✓ Haz esto
✓ Pregunta “¿cómo lo haría yo con un empleado nuevo?” antes de escribir cualquier instrucción.
✗ Evita este error
✗ Tratar la gestión de agentes como un tema técnico que solo entiende el programador.
Practica antes de revelar
Toma a un empleado o colega a quien ya hayas orientado y lista lo que le dijiste en la primera semana. Marca a qué principio corresponde cada cosa.
Ver respuesta comentada
Normalmente aparecen las reglas de la casa (contexto), dónde buscar información (datos) y qué puedes decidir tú solo (autonomía). Lo que suele faltar es el criterio escrito, porque con personas se va ajustando en la conversación. Con agentes, tiene que estar en el papel.
Lo que el agente no “captura”
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
Objetivo: convertir el “obvio” en una instrucción escrita.
Pega al final de tu instrucción y completa:
- Tono con el cliente: <ej.: siguiente, sin modismos, sin emojis>
- Fuente que vale: <ej.: planilla Agenda 2026, pestaña Confirmados>
- No vale: <ej.: mensajes antiguos de WhatsApp>
- Si falta información: “no inventes; escribe [FALTA DATO] y avísame”
- Detente y llámame cuando: <ej.: el cliente se queje o hable de cancelar>
Cómo verificar: pide al agente “antes de empezar, confirma en 3 líneas lo que entendiste”; si no cita la fuente y la regla de “si falta”, la instrucción sigue incompleta.
Del concepto a la acción
- Lo que tú sabes: identificar la condición inicial.
- Lo que es obvio: aplicar la decisión descrita.
- Lo que está escrito: comprobar el efecto en el ejemplo.
- Lo que el agente usa: registrar la evidencia de salida.
✓ Haz esto
✓ Escribe la regla de “si falta información” en toda instrucción, incluso si parece un exceso.
✗ Evita este error
✗ Suponer que el agente va a captar el tono o la fuente correcta “por el contexto”.
Practica antes de revelar
Lista tres cosas que cualquier persona de tu equipo sabe sin que nadie lo diga. Reescribe cada una como una frase de instrucción.
Ver respuesta comentada
Ejemplo: “nadie responde al cliente después de las 20h” se convierte en “no envíes mensajes después de las 20h; deja como borrador para la mañana”. El ejercicio muestra de cuánto de la operación dependen reglas nunca escritas.
Quien programa con agentes ya vive esto
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
Objetivo: ver los 7 principios en la práctica de un agente de código.
1 Intención → modo plano: “proponga el plan antes de alterar archivos”
2 Contexto → CLAUDE.md / AGENTS.md en la raíz del proyecto
3 Datos → “lee el archivo antes de afirmar algo sobre él”
4 Criterio → “solo está listo cuando <comando de prueba> pase”
5 Autonomía → modo de permiso: plan, default, acceptEdits
6 Observación → FALHAS.md: fecha, qué se rompió, menor corrección
7 Supervisión → revisión del código antes de publicar
Cómo verificar: para cada línea, pregunta cuál es el equivalente en tu área (ej.: FALHAS.md se vuelve una planilla de errores del servicio de atención).
✓ Haz esto
✓ Toma de la programación la regla “listo es lo que se comprueba, no lo que se declara”.
✗ Evita este error
✗ Creer que estas prácticas solo sirven para quienes escriben código.
Practica antes de revelar
Elige dos elementos de la lista (por ejemplo, modo plano y registro de fallas) y describe cómo aplicarías cada uno en una tarea que no es de programación.
Ver respuesta comentada
El modo plano se vuelve “muéstrame el guion del correo antes de enviarlo”; el registro de fallas se vuelve una tabla con fecha, error y corrección del agente de atención. La práctica es la misma; solo cambia el objeto.
Los modos de permiso son la escalera N0–N4 con un botón
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
Objetivo: elegir el modo de permiso según el nivel, no por impulso.
Regla del nivel (del skill de la ficha-agente):
consulta → N0 · prepara/rascunho → N1 · ejecuta → N3 · coordina procesos → N4
si N3+ E (dinero O irreversible O gente de afuera) → N2
si N2+ E y sin fuente oficial definida → N1
Mapa para Claude Code:
N0/N1 → plan
N2 → default + prohibiciones como reglas deny
N3 → acceptEdits + pruebas como criterio de listo + FALHAS.md
N4 → hooks que bloquean push, deploy y delete + entorno aislado
Mi caso: tarea <descríbase> → nivel <Nx> → modo <modo>
Cómo verificar: si el modo elegido está por encima del nivel que indica la regla, bájalo. Si hay duda entre dos, quédate con el menor.
✓ Haz esto
✓ Empieza en plan o predeterminado y sube un escalón solo después de semanas sin correcciones.
✗ Evita este error
✗ Usar bypassPermissions en un repositorio conectado a producción.
Practica antes de revelar
Tu agente va a corregir textos del sitio y también publicar la versión nueva en vivo. ¿Qué nivel y qué modo indica la regla?
Ver respuesta comentada
Publicar en vivo es irreversible e involucra gente de fuera (los visitantes), así que la regla baja a N2: modo predeterminado, con la publicación como regla deny. Él edita, tú apruebas y tú publicas. Puedes subir cuando haya semanas de aprobaciones sin corrección.
Instrucciones, pruebas y hooks: el método en producción
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
Objetivo: pega y pega en CLAUDE.md o AGENTS.md el nivel y las prohibiciones del agente.
## Agente de este proyecto
Nivel: <N2> · <prepara, humano apruebas>. Modo de permiso: <default>.
Misión: <qué hace y por qué importa>.
Fuente de verdad: el repositorio. Lee el archivo antes de afirmar algo sobre él.
Listo = <npm test> pasa sin errores. No declares “listo” antes de eso.
### Nunca lo hagas solo
- git push, deploy o publicación
- borrar archivos o carpetas fuera de <carpeta de trabajo>
- modificar <.env / datos de clientes>
Si te lo piden, di que me lo paso a mí.
### Detente y llámame cuando
- un test falla dos veces seguidas
- que la tarea requiera tocar fuera de <carpeta de trabajo>
### Registro
Anota cada fallo en FALHAS.md: fecha, qué se rompió, corrección más pequeña.
Cómo verificar: abre una sesión nueva y pide “resuma en 3 líneas sus reglas en este proyecto”; debe citar el nivel, el criterio de “listo” y las prohibiciones.
Del concepto a la acción
- Instrucción escrita: identificar la condición inicial.
- Prueba automática: aplicar la decisión descrita.
- Regla deny: verificar el efecto en el ejemplo.
- Hook que bloquea: registrar la evidencia de salida.
✓ Haz esto
✓ Repite las prohibiciones graves como regla deny o hook, además del texto.
✗ Evita este error
✗ Confiar solo en la solicitud hecha en el chat para algo irreversible.
Practica antes de revelar
Toma el CLAUDE.md o AGENTS.md de tu proyecto (o crea uno) y agrega el bloque de nivel, el criterio de listo y tres prohibiciones.
Ver respuesta comentada
El bloque mínimo tiene nivel, fuente de verdad, definición de listo y prohibiciones con “si te lo piden, pásamelo”. Si el proyecto tiene deploy, la prohibición de deploy también debe volverse regla deny, porque el texto por sí solo depende de que el agente obedezca.
El cuello de botella es la claridad, no la IA
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
Objetivo: convertir un error del agente en una regla, en lugar de culpar a la herramienta.
Error observado: <qué hizo mal>
¿Qué principio faltó? (marca uno)
[ ] intención [ ] contexto [ ] datos [ ] criterio
[ ] autonomía [ ] observación [ ] supervisión
Nueva regla (una frase): <ej.: “si el precio no está en la tabla, escribe [FALTA PRECIO]”>
Dónde entra: <en la sección de la ficha o del CLAUDE.md>
Línea en el registro: | <fecha> | <qué se rompió> | <menor corrección> | <regla actualizada> |
Cómo verificar: repite la misma situación la semana siguiente; si el error no volvió, la regla funcionó.
✓ Haz esto
✓ Para cada error, pregunta “¿cuál de las 7 preguntas no respondí?”.
✗ Evita este error
✗ Cambiar de herramienta o de modelo antes de revisar la instrucción.
Practica antes de revelar
Recuerda un error reciente de una IA que uses. Clasifícalo en uno de los tres síntomas (intención, fuente, criterio) y escribe la regla que lo evitaría.
Ver respuesta comentada
Casi siempre el error encaja en uno de los tres: tarea equivocada (intención), dato equivocado (fuente) o entrega incompleta (criterio). La buena regla es corta, específica y comprobable en la semana siguiente.
Revise su comprensión
Un agente entregó, con mucha eficiencia, un reporte sobre el tema equivocado. Según el secreto de los 7 principios, ¿cuál es la causa más probable?
¿Qué se lleva de este módulo?
Reconocer cada principio en una práctica de gestión que ya usas y traducirla en una instrucción escrita para un agente, incluso en un agente de código.
- Es gestión de personas con otro nombre.
- Lo que el agente no “captura” de inmediato.
- Quien programa con agentes ya vive esto.
- Los modos de permiso son la escalera N0–N4 con botón.
- Instrucciones, pruebas y hooks: el método en producción.
- El cuello de botella es la claridad, no la IA.
Próxima acción: aplique lo que aprendió en la ficha de su agente y anote qué aún necesita revisión.