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

> ¿Cómo creo un agente de IA?

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'.

> Fuente: https://magoallegri.com/biblioteca/como-crear-tu-primer-agente

---

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.

[Figura: 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?)

> [!info] **Checkpoint** — Briefing escrito con las cuatro piezas, plan aprobado por vos antes de ejecutar, ejecución mirada, y reporte verificado contra tu definición de "listo". Eso fue delegar de verdad.

## 💡 El nivel siguiente: Cowork

Cuando este flujo te salga natural, conocé la pestaña **Cowork** de la app: el mismo patrón (encargo → trabaja solo → reporte), pero corriendo en la nube mientras vos seguís con lo tuyo, incluso con la compu cerrada. Mismo briefing, mismas reglas de manager — solo cambia dónde trabaja.

## ⚠️ Si algo sale mal

- **El plan vino flojo o genérico.** Tu briefing tiene huecos — casi siempre en el "listo" o en los límites. Afinalos y pedí el plan de nuevo.
- **Se fue por las ramas a mitad de camino.** Interrumpí (botón de stop o escribí la corrección y Enter). Redirigir a tiempo también es ser manager.
- **El reporte dice "todo perfecto" y no era cierto.** Por eso verificás 2-3 afirmaciones al azar. Decíselo: `El punto X del reporte no es correcto: [QUÉ ENCONTRASTE]. Revisá y corregí.`

## 🟢 Hacelo ahora

1. Elegí tu encargo y escribí el briefing completo.
2. Plan → tu aprobación → ejecución mirada.
3. Verificación de manager (el "listo", 2-3 spot-checks, los límites).