promptbyprompt/agent-briefs

Resumos de agente

Um subagente começa com memória vazia. Ele sabe apenas o que você escreve. Antes de iniciar qualquer subagente, workflow ou tarefa longa, escreva um resumo com templates/brief.md (na pasta deste skill).

Passos

1. Tarefa grande com várias partes: primeiro execute um agente de planejamento com templates/planner.md. Ele retorna de 5 a 8 estágios, cada um com um done_when mensurável. Cada estágio então recebe seu próprio resumo.
2. Trabalho de qualidade (música, som, visuais, estilo de escrita): primeiro siga templates/reference.md. Colete de 2 a 3 referências, meça-as, escreva a lacuna, prototipe uma peça e deixe o proprietário julgá-la antes do restante.
3. Escreva o resumo com cada cabeçalho de templates/brief.md. Escreva "nenhum" sob um cabeçalho que não se aplique. Cole templates/test-policy.md em todo resumo que construa ou altere algo.
4. Após uma etapa de construção, revise com 2 ou 3 críticos de templates/critic.md, em paralelo, sobre o mesmo material gravado. Dê a lista mesclada de must_fix a um agente de correção.
5. Inicie um watchdog ao lado de cada agente que execute por mais de cerca de 15 minutos (veja abaixo).
6. Informe ao usuário o que você iniciou, o orçamento e uma estimativa honesta. Diga o que é incerto.

Regras para todo resumo

• Ler primeiro: aponte para arquivos e seções em vez de colar contexto longo.
• Cite as palavras do proprietário (traduzidas se necessário), para que o agente veja o que foi realmente solicitado.
• Se o proprietário estiver ausente, diga: "O proprietário não pode responder. Decida por si mesmo e registre cada decisão."
• Os critérios de conclusão devem ser verificáveis por um script, um teste ou uma medição. Use números e faixas.
• Um agente não pode ver ou ouvir como uma pessoa. Faça-o medir (capturas de tela, contagens de quadros, volume, picos), dizer no relatório o que ninguém olhou ou ouviu, e deixar o gosto para o proprietário.
• Todo resumo tem um orçamento de tempo, um orçamento de teste e uma regra de parada: "Quando o tempo acabar, pare, anote o que resta e retorne." Tarefas longas também recebem um ponto de verificação ("Às 2 h, se X não tiver começado, recue para Y").
• Nunca escreva "reexecutar todos os testes anteriores" ou "manter tudo funcionando" sem limites. Teste a nova parte em seu local; reexecute um teste antigo apenas se você alterou o que ele cobre.
• Liste prioridades para o caso de o tempo acabar, do mais importante primeiro, e diga o que acontece com o restante.
• Os entregáveis mantêm os nomes, formatos e comprimentos do que substituem, para que a próxima etapa possa trocá-los.
• Um arquivo de progresso recebe uma linha com timestamp por peça concluída, para que o trabalho sobreviva a uma interrupção.
• As regras rígidas informam o motivo ("Nunca salvar X: salvar apagaria suas referências").
• Carregue falhas anteriores como regras ("um clipe anterior exibiu preto: use perfil Main e yuv420p").
• Defina limites de tempo para missões secundárias arriscadas: "Gaste no máximo 15 minutos nisso, depois recue para Y."
• Agentes paralelos recebem cercas de escopo: "O Passo 3 NÃO é seu trabalho: não toque em A ou B."
• Solicite um formato de retorno fixo: o que foi feito, o que foi pulado e por que, medições, tempo de teste, tempo usado, uma estimativa para o restante, localizações dos arquivos.

Watchdog

Ao lado de cada agente longo, inicie um comando em segundo plano que espera pelo orçamento de tempo e então imprime uma linha:

sleep 5400; echo "ORÇAMENTO excedido: estágio 3 (90 min)"

Execute-o em segundo plano (o Claude Code notifica você quando ele termina). Quando ele disparar: leia o arquivo de progresso do agente e então diga ao agente para concluir e retornar, ou pare-o, ou estenda o orçamento uma vez e informe o usuário. Se o agente retornar cedo, pare o watchdog.