Mago Allegri

Cómo crear un agente de IA (tu primero, con Claude Code)

Por Juan Martín «Mago» Allegri · Actualizado:

Escribís un briefing con las cuatro piezas —objetivo con su 'listo' verificable, herramientas, límites y reporte—, le pedís a Claude el plan ANTES de ejecutar, lo aprobás, mirás la primera ejecución entera y después verificás el resultado contra tu definición de 'listo'.

Antes conviene leer: Qué es un agente de IA (sin humo)

Crear un agente de IA es delegar de verdad: no un cambio, no una rutina, sino una tarea grande de varios pasos que Claude planifica y ejecuta mientras vos hacés de manager. Las cuatro piezas de un agente (objetivo, herramientas, permisos, reporte) dejan de ser teoría: son el briefing que estás por escribir.

Delegar de verdad: briefing, plan, tu OK, ejecución y verificación

Elegí el encargo

Para el primer agente, una tarea con sustancia pero acotada. Ideas que funcionan:

  • El auditor: “revisá mi sitio completo (todas las páginas) y armame un informe: links rotos, textos con errores, inconsistencias de estilo, qué mejorarías primero.”
  • El investigador: “investigá [TU NICHO]: los 5 competidores con mejor presencia, qué ofrecen, qué promete cada uno, y dónde hay un hueco para mí.”
  • El armador: “armá la estructura completa de [PROYECTO CHICO]: carpetas, archivos base, y un plan de qué construir en qué orden.”

El briefing (las cuatro piezas, por escrito)

Te encargo una tarea. Primero el briefing completo, después te pido el plan.

OBJETIVO: [QUÉ HAY QUE LOGRAR]
"Listo" significa: [CÓMO SE VERIFICA QUE QUEDÓ BIEN — CONCRETO]

PODÉS USAR: [ARCHIVOS / CONECTORES / INTERNET — SOLO LO NECESARIO]

LÍMITES:
- [QUÉ NO HACER, P. EJ. "no modifiques ningún archivo: solo leé e informá"]
- Si te falta información, anotala como pendiente — no inventes.

REPORTE FINAL: [QUÉ QUERÉS VER Y EN QUÉ FORMATO]

Antes de ejecutar: mostrame tu plan de trabajo, paso por paso.
No empieces hasta que te lo apruebe.

Plan primero — siempre

Esa última línea es la jugada de manager más importante que existe. Claude te muestra el plan; vos lo leés antes de que pase nada. ¿Entendió el objetivo? ¿Hay un paso que te hace ruido? ¿Falta algo? Corregir un plan cuesta una frase; corregir una ejecución cuesta la tarde.

(La app tiene un modo pensado para esto — Plan mode, en el selector de permisos — donde Claude solo planifica y no toca nada. Es el modo natural de empezar cualquier encargo grande.)

Cuando el plan te cierre: Aprobado, ejecutá. Y mirá la primera ejecución entera. No porque vaya a salir mal: porque mirar la primera vez es lo que te permite no mirar la décima.

Verificá como manager

Terminó y te dio su reporte. Tu trabajo no terminó:

  1. ¿Cumple la definición de “listo” que vos escribiste? Verificala punto por punto.
  2. Elegí 2 o 3 afirmaciones del reporte y comprobalas vos mismo (un link, un dato, un archivo).
  3. ¿Respetó los límites? (¿Tocó algo que no debía?)