🤖 Agentes y Automatizaciones Arquitectura de agentes
0 / 35

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.


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