# Las 6 cláusulas del briefing de un agente

> ¿Cómo escribo el briefing de un agente de IA?

Un briefing de producción tiene seis cláusulas: objetivo con su 'listo' verificable, los pasos del camino feliz, los límites duros (el 'jamás'), el manejo de lo ambiguo (qué hace cuando no sabe), el reporte y el plan de fallo. Un sistema que corre solo es tan bueno como su briefing.

> Fuente: https://magoallegri.com/biblioteca/como-escribir-el-briefing-de-un-agente

---

Todo agente corre sobre un documento: **su briefing** — el contrato que define qué hace, qué jamás, y cómo se sabe que lo hizo bien. La versión básica tiene cuatro piezas; la de producción la profundiza a seis cláusulas, porque un sistema que corre solo es exactamente tan bueno como su briefing.

## Las seis cláusulas

[Figura: El briefing de un agente como contrato de seis cláusulas: objetivo, pasos, límites, lo ambiguo, reporte y plan de fallo.]

1. **El objetivo, con su "listo" verificable.** No "gestionar los leads", sino *"cada lead nuevo queda registrado, clasificado y con respuesta preparada en menos de 10 minutos — verificable en la planilla"*. La vara: otra persona podría auditar el cumplimiento sin preguntarte nada.
2. **Los pasos del camino feliz.** La secuencia cuando todo va bien, numerada y sin ambigüedad. Marcá qué paso es regla y cuál es criterio.
3. **Los límites duros.** El "jamás" de esta pieza: qué no toca, qué no envía, dónde se frena. Se escriben redundantes con tu política de autonomía — 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 cuando no sabe?** La respuesta correcta casi siempre: *"lo ambiguo se marca, se aparta y se pregunta — nunca se adivina"*. Un sistema que duda en voz alta es confiable aunque sea simple; uno que adivina es peligroso aunque sea brillante.
5. **El reporte.** Qué informa, cuándo y 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?

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

El test de calidad: 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 improvise, falta una cláusula. Es mucho más barato descubrir el hueco acá que en producción.

## Para los casos ambiguos probables

En el agente que toma decisiones de criterio, detallá la cláusula 4: listá los casos ambiguos probables con su manejo. Por ejemplo: *"si el mensaje mezcla consulta y queja → clasificar queja, prioridad alta, pasar a humano"*. Cuanto más anticipás, menos improvisa.