# Briefing de agentes

> Agentes y Automatizaciones · Arquitectura de agentes
> Fuente: https://magoallegri.com/cursos/agentes/arquitectura-de-agentes/briefing-de-agentes

---

Toda pieza de tu lista va a correr sobre un documento: **su briefing** — el contrato que define qué hace, qué jamás, y cómo se sabe que lo hizo bien. El camino te dio la versión de cuatro piezas; el lab la profundiza a contrato de producción — porque un sistema que corre solo es exactamente tan bueno como su briefing.

## El briefing completo (las seis cláusulas)

**1. El objetivo, con su "listo" verificable.** No "gestionar los leads": *"cada lead nuevo queda registrado, clasificado y con respuesta preparada en menos de 10 minutos — verificable en la planilla"*. La vara: otra persona (u otro agente) podría auditar el cumplimiento sin preguntarte nada.

**2. Los pasos del camino feliz.** La secuencia cuando todo va bien — numerada, sin ambigüedad. (Para los sándwiches: marcando qué paso es regla y cuál es el bocado de criterio.)

**3. Los límites duros.** El "jamás" de esta pieza: qué no toca, qué no envía, dónde se frena. Heredan de tu política de autonomía — y se escriben REDUNDANTES con ella (el límite repetido no estorba; el ausente cuesta).

**4. El manejo de lo ambiguo.** La cláusula que separa briefings amateur de profesionales: **¿qué hace el sistema cuando NO sabe?** La respuesta correcta casi siempre: *"lo ambiguo se marca, se aparta y se pregunta — nunca se adivina"* (el /revisar del camino, institucionalizado). Un sistema con buen manejo de ambigüedad es confiable aunque sea simple; uno que adivina es peligroso aunque sea brillante.

**5. El reporte.** Qué informa, cuándo, en qué formato — según su nivel de autonomía (el nivel 2 reporta para aprobar; el 3, para auditar; el 4, solo desvíos).

**6. El plan de fallo.** Si un paso falla: ¿reintenta? ¿cuántas veces? ¿a quién avisa? ¿qué queda en qué estado? (Tu plan B manual del M1 se conecta acá.)

## Escribí los contratos del lab

```
Leé lista-del-lab.md (fichas completas: arquitectura, piezas,
autonomía). Los briefings de producción:

1. Para CADA pieza de la lista: el contrato completo de seis
   cláusulas — concreto, verificable, con el manejo de ambigüedad
   explícito.
2. Para EL AGENTE (el del bocado de criterio): la cláusula 4 en
   detalle — los casos ambiguos PROBABLES listados con su manejo
   ("si el mensaje mezcla consulta y queja → clasificar queja,
   prioridad alta, humano").
3. El formato: cada briefing como documento independiente en
   /briefings del proyecto — son los archivos que los módulos
   3-5 van a ejecutar.
```

## La prueba del briefing (antes de construir nada)

El test de calidad de un contrato: dáselo a Claude en una sesión limpia y preguntale **"¿qué harías si [CASO RARO]?"** — tres casos raros por briefing. Si las respuestas salen del documento (no de la imaginación), el briefing está completo; donde Claude improvise, falta una cláusula. Es la prueba de fuego del brief del lab de creativos, aplicada a sistemas — y es mucho más barata que descubrir el hueco en producción.

> [!info] **Checkpoint** — /briefings tiene el contrato completo de cada pieza del lab, todos aprobados por la prueba de los casos raros. La construcción de los módulos 3-5 ya tiene sus documentos rectores.

## 🟢 Hacelo ahora

1. Los briefings completos, pieza por pieza.
2. La prueba de casos raros en cada uno (tres por briefing, sin piedad).
3. Notá lo que pasó: el módulo todavía no construyó NADA y tu proyecto ya tiene auditoría, arquitectura, piezas, autonomía y contratos. Así construyen los que no se arrepienten.

---

Contratos firmados. Cierre del módulo: **supervisión** — aprobar, auditar y apagar: el trabajo del dueño de sistemas, sistematizado.