# Brief maestro

Qué es: la plantilla del encargo que le das al agente principal antes de delegar.
Cómo se usa: completá los corchetes, pegalo entero como primer mensaje del turno.
De dónde salió: Totem · megatotem.com · actualizado julio 2026

---

## La plantilla

```text
Objetivo: [el resultado concreto, en una oración]

Contexto: [qué es este proyecto, qué estado tiene, qué decidimos antes]

Entregables:
- [artefacto 1: nombre de archivo y qué tiene adentro]
- [artefacto 2]
- una síntesis con decisiones, evidencia, contradicciones e incertidumbres

Restricciones:
- Cada agente edita únicamente su archivo asignado.
- Toda afirmación factual lleva fuente, archivo y línea, o se marca como supuesto.
- Ninguna herramienta externa se considera autorizada por defecto.
- Escalá a mí si hace falta una credencial, un dato personal, un permiso nuevo
  o un cambio fuera de este directorio.

Criterio de terminado:
- Los artefactos están completos y sin contradicciones entre sí.
- Los riesgos están priorizados y cada uno tiene dueño.
- Cada afirmación importante es rastreable hasta su fuente.
- Existe una recomendación explícita: avanzar, iterar o parar.
```

## Las cinco piezas, y por qué cada una

**Objetivo.** Una oración. Si necesitás dos, probablemente sean dos trabajos.
El objetivo es lo que el agente principal va a defender cuando un subagente
vuelva con algo distinto.

**Contexto.** Lo que ya decidiste y no querés volver a discutir. Es más barato
escribir tres líneas acá que corregir cuatro informes después.

**Entregables.** Con nombre de archivo. El nombre del archivo es lo que
convierte «investigá esto» en un encargo verificable, y es también lo que evita
que dos agentes escriban encima del mismo texto.

**Restricciones.** Las cuatro de la plantilla cubren el 90% de los accidentes:
pisadas de archivo, afirmaciones inventadas, herramientas que nadie autorizó y
agentes que se quedan trabados esperando un permiso que vos nunca viste.

**Criterio de terminado.** Sin esto, «los agentes terminaron» se confunde con
«el trabajo está bien». Son cosas distintas.

## Ejemplo completo

```text
Objetivo: decidir si podemos habilitar el resumen automático de tickets para el
equipo de soporte, o qué falta para poder decidirlo.

Contexto: plataforma interna de gestión de proyectos. Todavía no hay datos
reales conectados; trabajamos con un set sintético en fixtures/. Ya decidimos
que la función no envía mensajes ni cierra tickets: sólo redacta borradores.

Entregables:
- producto.md: usuarios, problema, alcance, qué queda afuera, métricas y umbrales
- riesgos.md: amenazas, controles, casos de prueba y puerta de salida
- una síntesis con la recomendación y las contradicciones que hayan aparecido

Restricciones:
- producto.md lo escribe sólo el agente de producto; riesgos.md sólo el de
  seguridad. Nadie toca el archivo del otro.
- Nada de datos reales de clientes. Sólo fixtures/.
- Sin conectores, sin red, sin repositorios externos.
- Escalá a mí cualquier cosa que necesite una credencial.

Criterio de terminado:
- Cada requisito tiene un criterio de aceptación observable.
- Cada riesgo alto tiene control probado o aceptación explícita.
- La síntesis dice avanzar, iterar o parar, y por qué.
```

## Lo que no va en un brief

- Instrucciones de estilo largas. Eso va en `AGENTS.md`, se lee una sola vez y
  no se repite en cada encargo.
- Credenciales, tokens, cookies o rutas privadas. Nunca, en ningún prompt.
- «Hacelo lo mejor posible». No es un criterio; es una forma elegante de no
  tener uno.