promptbyprompt/agent-briefs

Informes de agente (briefs)

Un subagente comienza con una memoria vacía. Solo sabe lo que tú escribes. Antes de iniciar cualquier subagente, flujo de trabajo o tarea larga, escribe un informe con templates/brief.md (en la carpeta de este skill).

Pasos

1. Tarea grande con varias partes: primero ejecuta un agente de planificación con templates/planner.md. Devuelve de 5 a 8 etapas, cada una con un done_when medible. Cada etapa recibe entonces su propio informe.
2. Trabajo de calidad (música, sonido, imágenes, estilo de escritura): primero sigue templates/reference.md. Recopila 2 o 3 referencias, mídelas, escribe la brecha, crea un prototipo y deja que el propietario lo evalúe antes del resto.
3. Escribe el informe con cada encabezado de templates/brief.md. Escribe "ninguno" bajo un encabezado que no aplique. Pega templates/test-policy.md en cada informe que construya o modifique algo.
4. Después de un paso de construcción, revisa con 2 o 3 críticos de templates/critic.md, en paralelo, sobre el mismo material grabado. Entrega la lista combinada de must_fix a un agente de corrección.
5. Inicia un watchdog junto a cada agente que se ejecute durante más de unos 15 minutos (ver más abajo).
6. Dile al usuario qué iniciaste, el presupuesto y una estimación honesta. Indica qué es incierto.

Reglas para cada informe

• Leer primero: señala archivos y secciones en lugar de pegar contexto largo.
• Cita las palabras del propietario (traducidas si es necesario), para que el agente vea lo que realmente se pidió.
• Si el propietario no está presente, dilo: "El propietario no puede responder. Decide tú mismo y registra cada decisión."
• Los criterios de finalización deben ser verificables mediante un script, una prueba o una medición. Usa números y rangos.
• Un agente no puede ver ni oír como una persona. Haz que mida (capturas de pantalla, conteo de fotogramas, volumen, picos), que indique en el informe lo que nadie ha mirado o escuchado, y deja el gusto al propietario.
• Cada informe tiene un presupuesto de tiempo, un presupuesto de pruebas y una regla de parada: "Cuando se acabe el tiempo, detente, anota lo que queda y regresa." Las tareas largas también tienen un punto de control ("A las 2 h, si X no ha comenzado, recurre a Y").
• Nunca escribas "vuelve a ejecutar todas las pruebas anteriores" o "mantén todo funcionando" sin límites. Prueba la nueva parte en su ubicación; vuelve a ejecutar una prueba anterior solo si cambiaste lo que cubre.
• Enumera las prioridades para el caso de que se acabe el tiempo, de mayor a menor importancia, e indica qué sucede con el resto.
• Los entregables mantienen los nombres, formatos y longitudes de lo que reemplazan, para que el siguiente paso pueda intercambiarlos.
• Un archivo de progreso recibe una línea con marca de tiempo por cada pieza terminada, para que el trabajo sobreviva a una interrupción.
• Las reglas estrictas establecen la razón ("Nunca guardes X: guardarlo borraría sus referencias").
• Traslada los fallos anteriores como reglas ("un clip anterior se reprodujo en negro: usa perfil Main y yuv420p").
• Limita el tiempo de las misiones secundarias riesgosas: "Dedica como máximo 15 minutos y luego recurre a Y."
• Los agentes paralelos reciben vallas de alcance: "El paso 3 NO es tu trabajo: no toques A ni B."
• Solicita un formato de retorno fijo: qué se hizo, qué se omitió y por qué, mediciones, tiempo de prueba, tiempo utilizado, una estimación para el resto, ubicaciones de los archivos.

Watchdog

Junto a cada agente de larga duración, inicia un comando en segundo plano que espera el presupuesto de tiempo y luego imprime una línea:

sleep 5400; echo "PRESUPUESTO superado: etapa 3 (90 min)"

Ejecútalo en segundo plano (Claude Code te notifica cuando finaliza). Cuando se active: lee el archivo de progreso del agente, y luego dile al agente que concluya y regrese, o detenlo, o extiende el presupuesto una vez e informa al usuario. Si el agente regresa antes de tiempo, detén el watchdog.