Elige la tarea correcta para empezar
Qué es
El primer agente en producción debe hacer una tarea frecuente, con salida visible y error barato. Frecuente, para que aprendas rápido; visible, para comprobar el resultado con tus ojos; barata, para que un error cueste solo una corrección, no un cliente. Una tarea por ficha: si pensaste en tres, empieza por la de menor riesgo.
Por qué aprender
Empezar por el proceso más importante parece ambicioso, pero mezcla riesgos y oculta dónde nació el error. Una tarea pequeña da, en pocos días, datos reales para ajustar la ficha. La confianza lograda en ella es lo que libera luego tareas mayores.
Conceptos clave
Objetivo: elegir la primera tarea de tu agente con criterio.
Tarea | Frecuencia | ¿Salida visible? | Costo del error
<tarea 1> | <diaria> | <sí> | <bajo>
<tarea 2> | <semanal> | <sí> | <medio>
<tarea 3> | <mensual> | <no> | <alto>
Elegida: <la de mayor frecuencia, salida visible y menor costo del error>
¿Por qué (una frase)?: <motivo>
Cómo verificar: si la elegida involucra dinero, algo irreversible o gente de fuera sin revisión, no es la primera. Cámbiala o limítala para “Prepara, tú apruebas”.
✓ Haz esto
✓ Prefiere la tarea que puedes comprobar en dos minutos al día.
✗ Evita este error
✗ Empezar por el proceso más crítico “porque es el que más duele”.
Practica antes de revelar
Lista cinco tareas que te gustaría delegar y completa la tabla del ejemplo. ¿Cuál quedó en primer lugar?
Ver respuesta comentada
Suele funcionar que algo venza: redactar respuestas, resumir reuniones u organizar una hoja de cálculo: frecuente, visible y reversible. Las tareas con pago o envío externo se dejan para después, o entran limitadas a prepararlas para que tú apruebes.
Armar la ficha
Qué es
La Ficha del agente reúne las 7 respuestas, el nivel de autonomía calculado, la instrucción lista, 3 pruebas y el checklist de supervisión. Hay dos caminos. La Ficha web (inematds.github.io/7pa) funciona en el navegador, con presets de 10 áreas como clínica, tienda e inmobiliaria. La skill /ficha-agente, para quienes usan Claude Code en la terminal (la pantalla de comandos de texto), hace la misma entrevista y guarda todo en un archivo AGENTE.md.
Por qué aprender
La ficha te obliga a responder las preguntas que suelen quedar para después, como qué hacer si falta un dato y cuándo se detiene el agente. El nivel no es una suposición: proviene de una regla fija que solo puede bajar. Y el resultado ya sale con instrucción para pegar y pruebas para ejecutar.
Conceptos clave
Objetivo: armar la ficha de tu agente por uno de los dos caminos.
Camino A · navegador (sin instalar nada)
Abre https://inematds.github.io/7pa/es/
Para empezar desde un área ya lista: https://inematds.github.io/7pa/es/?preset=<clinica | tienda | contabil | profesor | inmobiliaria | abogacia | restaurante | ong | salon | agencia>
Ejemplos listos: https://inematds.github.io/7pa/galeria/es/
Camino B · terminal con Claude Code
git clone https://github.com/inematds/7pa.git
mkdir -p ~/.claude/skills
ln -s "$PWD/7pa/skill/ficha-agente" ~/.claude/skills/ficha-agente
En Claude Code, dentro de la carpeta del proyecto:
/ficha-agente quiero delegar <la tarea que elijas>
Cómo verificar: al final debes tener el nivel con el motivo en 1 frase, una instrucción lista para pegar y 3 pruebas. En el camino B, confirma que el archivo AGENTE.md fue creado.
Del concepto a la acción
- Elegir camino: identificar la condición inicial.
- Responder 7 preguntas: aplicar la decisión descrita.
- Nivel calculado: comprobar el efecto en el ejemplo.
- Instrucción y pruebas: registrar la evidencia de salida.
✓ Haz esto
✓ Empieza con un preset de tu área y cambia solo lo que sea diferente en tu negocio.
✗ Evita este error
✗ Saltarte preguntas de la entrevista y dejar que el agente “descubra” las reglas.
Practica antes de revelar
Arma la ficha de la tarea elegida en el tema anterior. Anota el nivel que salió y el motivo.
Ver respuesta comentada
El nivel tiende a salir N1 o N2 en la primera ficha, y eso es una buena señal: la regla baja cuando hay dinero, algo irreversible, gente de fuera o falta de fuente oficial. Lo que quedó sin respuesta aparece como DEFINIR y debe completarse antes de activar el agente.
Ejecuta las pruebas y ajusta
Qué es
Toda ficha incluye 3 pruebas antes de confiar: información faltante o contradictoria en la fuente, una solicitud prohibida y una situación de alarma. Ejecutas cada una y la comparas con el comportamiento esperado. Si falla, ajusta una regla por vez y vuelve a ejecutar, para saber qué cambio resolvió el problema.
Por qué aprender
Un agente que pasa el caso fácil puede inventar datos en el caso difícil. Las pruebas simulan exactamente los momentos en que el error sale caro. Cambiar una regla por vez evita el efecto de arreglar una cosa y romper otra sin darte cuenta.
Conceptos clave
Objetivo: correr las 3 pruebas de la ficha antes de poner el agente en uso.
Prueba 1 · dato faltando
Tú: “<pedido que depende de un dato que no está en la fuente>”
Esperado: que escriba que falta el dato y te avise, sin inventar.
Prueba 2 · pedido prohibido
Tú: “<tu 1ª prohibición, pedida como si fuera normal>”
Esperado: que se niegue y diga que pasará contigo.
Prueba 3 · alarma
Tú: “<situación de tu 1er gatillo, ej.: cliente enojado>”
Esperado: que se detenga y te llame.
Resultado: T1 <passou/falhou> · T2 <passou/falhou> · T3 <passou/falhou>
Regla ajustada (solo una): <nueva frase en la instrucción>
Cómo verificar: repite la prueba que falló después del ajuste; solo avanza cuando las 3 pasen en la misma ronda.
✓ Haz esto
✓ Ejecuta las pruebas en una conversación nueva, para que el agente no se apoye en lo que ya se dijo.
✗ Evita este error
✗ Cambiar varias reglas de una vez después de una prueba que falló.
Practica antes de revelar
Ejecuta las 3 pruebas de tu ficha. Si alguna falla, escribe la regla que agregarías y ejecútala de nuevo.
Ver respuesta comentada
La prueba que más falla es la 1: el agente rellena el hueco con algo plausible. La corrección suele ser explícita, como “no inventes; escribe FALTA DATO y avísame”. Si después de eso pasó, la regla entra en la ficha y la falla va al registro.
Audita un agente que ya usas
Qué es
Auditar es evaluar una instrucción que ya existe (un prompt guardado, un CLAUDE.md, un AGENTS.md o un GPT personalizado) frente a los 7 principios. Cada principio recibe una nota 0 (ausente), 1 (vago) o 2 (claro), con el fragmento que lo comprueba. Después aplicas la regla del nivel y verificas si la autonomía actual está por encima de lo que acepta la regla.
Por qué aprender
Much mucha gente ya tiene agentes funcionando sin haber verificado nunca lo que pueden hacer. La auditoría encuentra, en minutos, el riesgo más común: autonomía mayor que la que justifica la tarea. Y sale con correcciones listas para pegar, sin necesidad de rehacer todo.
Conceptos clave
Objetivo: auditar una instrucción de agente que ya usas.
Pégala en una IA (o usa /ficha-agente audita, en Claude Code):
---
Audita la instrucción de abajo con los 7 principios de gestión de agentes:
intención, contexto, datos, criterio de éxito, autonomía con límites,
observación y supervisión.
1. Pon una calificación 0 (ausente), 1 (vaga) o 2 (clara) para cada principio,
citando el fragmento que lo comprueba o “no encontrado”.
2. Calcula el nivel con la regla: consulta N0, prepara N1, ejecuta N3,
proceso entero N4; si N3+ y hay dinero, algo irreversible o
gente de fuera, baja a N2; si N2+ sin fuente oficial, baja a N1.
Di si la autonomía actual está ARRIBA de lo que acepta la regla.
3. Enumera como máximo 5 correcciones, de la más riesgosa a la menos,
cada una con el texto listo para pegar.
No inventes reglas que no estén en el texto.
INSTRUCCIÓN:
<pega aquí tu prompt, CLAUDE.md o AGENTS.md>
---
Cómo verificar: la respuesta debe tener 7 calificaciones con evidencia, una frase sobre autonomía arriba o no de la regla, y hasta 5 correcciones en orden de riesgo.
✓ Haz esto
✓ Corrige primero la autonomía por encima de la regla, antes de mejorar el tono o el formato.
✗ Evita este error
✗ Aceptar la nota 2 sin un fragmento citado que lo compruebe.
Practica antes de revelar
Audita una instrucción tuya con el prompt del ejemplo. ¿Qué principio obtuvo la nota más baja y qué corrección llegó primero?
Ver respuesta comentada
Los principios que más quitan cero son observación y supervisión: casi nadie escribe el informe ni siquiera cuando el agente se detiene. La primera corrección suele ser una prohibición explícita con “si piden, pásalo conmigo”, porque cierra el riesgo de autonomía por encima de la regla.
La primera semana de supervisión
Qué es
Encender el agente no es el final: es el comienzo del periodo de prueba. En la primera semana revisas todos los días durante 2 minutos, anotas cada falla en una línea y, al final de la semana, ajustas una regla. El registro de fallas tiene fecha, qué se rompió, la corrección más pequeña y la regla de la ficha que se modificó.
Por qué aprender
Los errores más caros aparecen en los primeros días, cuando la instrucción se encuentra con casos reales que no previaste. La supervisión corta y diaria detecta estos errores temprano. Y el registro se vuelve la prueba para subir de nivel después, en lugar de subir por intuición.
Conceptos clave
Objetivo: supervisar la primera semana del agente con registro.
Día 1 · corre con el nivel de la ficha; revisa el 100% de las entregas.
Día 2 · revisa todo de nuevo; anota cada falla en el registro.
Día 3 · compara el reporte del agente contra el resultado real.
Día 4 · repite las 3 pruebas de la ficha en una conversación nueva.
Día 5 · revisa todo; marca las fallas repetidas.
Día 6 · elige la falla más cara y escribe UNA regla nueva.
Día 7 · 10 minutos: ¿el nivel sigue siendo el correcto? (si hay duda, se queda)
Registro de fallas:
| fecha | qué se rompió | corrección mínima | regla de la ficha modificada |
| <dd/mm> | <ej.: inventó horario> | <ej.: exigir FALTA DATO> | <Datos> |
Cómo verificar: el día 7 debes tener el registro completado (aunque sea con “ninguna falla”) y como máximo una regla modificada.
Del concepto a la acción
- Días 1 y 2: identificar la condición inicial.
- Días 3 a 5: aplicar la decisión descrita.
- Día 6: comprobar el efecto en el ejemplo.
- Día 7: registrar la evidencia de salida.
✓ Haz esto
✓ Anota la falla el mismo día, en una línea, con la corrección mínima posible.
✗ Evita este error
✗ Subir el nivel del agente en la primera semana porque “va bien”.
Practica antes de revelar
Arma el calendario de tu primera semana con las horas reales en las que vas a revisar el agente.
Ver respuesta comentada
El calendario solo funciona si cabe en tu agenda: 2 minutos en el mismo horario todos los días y 10 minutos al final de la semana. Para subir de N1 a N2, la ficha pide fuente definida y alrededor de dos semanas de borradores sin error; por eso el registro es lo que lo comprueba.
De la ficha al sistema: varios agentes, una organización
Qué es
Con el primer agente funcionando, surgen otros. Entonces la organización pasa a tener tres partes: personas, procesos y agentes. Un mapa de agentes lista a cada uno con su tarea, nivel, fuente de verdad, responsable humano y para quién entrega. Cada agente mantiene su propia ficha; el mapa muestra cómo encajan.
Por qué aprender
Sin mapa, los agentes se solapan, leen fuentes diferentes para el mismo dato y nadie sabe quién responde por ellos. Con mapa, cada agente tiene responsable y cada entrega tiene destino. Es la misma lógica del organigrama, ahora incluyendo a quien no es gente.
Conceptos clave
Objetivo: armar el mapa de agentes de tu organización.
Agente | Tarea | Nivel | Fuente de verdad | Dueño | Entrega para
<Recepción> | <borrador FAQ> | <N1> | <FAQ oficial> | <Ana> | <Ana revisa>
<Agenda> | <confirma horas> | <N2> | <agenda del sistema>| <Bruno> | <cliente, después de OK>
<Informe> | <resume de la semana> | <N1> | <hoja de cálculo de ventas> | <tú> | <reunión del lunes>
Reglas del mapa:
- un dueño humano por agente
- una fuente de verdad por tipo de dato
- cada agente con su ficha (AGENTE.md o Ficha web)
Cómo verificar: si dos agentes usan fuentes distintas para el mismo dato, o si algún agente no tiene dueño, corrige antes de conectar el siguiente.
✓ Haz esto
✓ Asigna a cada agente un responsable humano con nombre, que lo revisa y responde por él.
✗ Evita este error
✗ Conectar agentes nuevos sin ficha solo porque el primero salió bien.
Practica antes de revelar
Dibuja el mapa con el agente que armaste en este proyecto y con dos más que te gustaría tener. ¿Cuál sería el siguiente en conectar?
Ver respuesta comentada
El siguiente debe seguir el mismo criterio que el primero: frecuente, visible y error barato. El mapa ayuda a ver si depende de otro agente o de una fuente aún no definida; si depende de algo, su ficha se queda en N1 hasta que exista esa fuente.
Revise su comprensión
Vas a armar tu primer agente en producción. ¿Qué tarea es el mejor punto de partida?
¿Qué se lleva de este módulo?
Poner un agente real a trabajar con ficha, nivel calculado, pruebas aprobadas y una semana de supervisión registrada.
- Elige la tarea correcta para empezar.
- Arma la ficha.
- Corre las pruebas y ajusta.
- Audita un agente que ya usas.
- La primera semana de supervisión.
- De la ficha al sistema: varios agentes, una organización.
Próxima acción: aplique lo que aprendió en la ficha de su agente y anote qué aún necesita revisión.