Wanbicoi/agent-config

O usuário pediu uma retrospectiva. Você está sugerindo melhorias no ambiente do agente de codificação para melhorar execuções futuras.

Etapas

1. Chame a ferramenta Skill com writing-for-agents para o guia de estilo de escrita.

2. Leia as fontes primárias da sessão que o usuário especificar. Isso pode significar pesquisar nos logs de sessão desta máquina. Se o usuário não especificar uma sessão, use a atual como padrão.

3. Procure candidatos a melhoria nestas categorias.

• Navegação: quão fácil foi para o agente encontrar os arquivos certos? Existem dependências ocultas entre arquivos? Um ponteiro de navegação facilitaria? Use quando a sessão demorou muito para encontrar uma informação.
• Verificações automatizadas: existem verificações automatizadas que poderiam capturar erros que o agente cometeu? Linting, tipagem, testes, linters de sistema de arquivos? Leia primeiro o comando de verificação do próprio repositório (seus scripts lint/check no package.json/ferramenta de build, seu workflow de CI), para que uma verificação que já existe mas está desconectada ou silenciosamente quebrada seja o achado, não uma reinvenção. Um repositório sem guarda-corpo (sem hook de pré-commit e sem job de CI executando seu comando de lint/typecheck/teste) é por si só um achado: um repositório sem lint é uma oportunidade perdida permanente, não um estado neutro padrão. Use quando o agente cometeu um erro que uma verificação automatizada poderia ter capturado, ou o repositório não tem guarda-corpo algum.
• Padrões de codificação: o agente revisor deve receber uma nova regra para impor? Uma regra existente deve ser removida ou esclarecida? Classifique primeiro a violação: uma mecânica (um padrão sintático fixo, uma API banida, uma forma de importação, uma regra de localização de arquivo) recebe uma verificação determinística, ponto final: uma regra personalizada no linter do próprio repositório, um novo hook de pré-commit ou um novo job de CI, o que for mais barato dado a linguagem do repositório e o guarda-corpo existente. Padrão: construir a verificação em vez de escrever a regra. Reserve CODING_STANDARDS.md para decisões de julgamento genuínas (consistência entre arquivos, "combina com o estilo ao redor", qualquer coisa que nenhum guarda-corpo poderia substituir). Use quando o agente revisor falhou ao capturar um erro.
• AGENTS.md global: existem instruções de direcionamento que deveriam ser movidas para padrões de codificação (ou verificações automatizadas)? Use quando o arquivo AGENTS.md estiver particularmente grande - no repositório OU no escopo global do usuário.
• Economia de ferramentas: o agente fez chamadas de ferramentas caras que poderiam ser simplificadas? Existe alguma ferramenta personalizada (CLIs, MCPs) que é particularmente ineficiente em termos de tokens? Use quando o agente fez uma chamada de ferramenta cara.
• No-ops: procure instruções em arquivos de direcionamento que não modificam o comportamento do agente. Use quando os arquivos de direcionamento forem grandes e difíceis de manejar.
• Acesso à informação: procure oportunidades para aumentar o acesso do agente à informação. Redirecionar logs do servidor de desenvolvimento, acesso somente leitura a serviços de terceiros. Use quando uma informação crucial não estava disponível para o agente.

4. Apresente estes candidatos ao usuário, em ordem de gravidade.

Referência

Implementação vs Revisão

Lembre-se de que todo trabalho passa por dois estágios: implementação e revisão. O agente de implementação tem a maior pressão de contexto. Ele é responsável por exploração, escrever código e depurar falhas.

O agente revisor tem a menor pressão de contexto - ele recebe um diff, portanto nenhuma exploração é necessária. Muitas vezes ele não precisa escrever código ou depurar.

Isso significa que o agente revisor deve ser responsável por impor padrões de codificação, não o agente de implementação.

Arquivos

Você tem acesso a vários arquivos no repositório:

• CLAUDE.md/AGENTS.md: esses arquivos são enviados para a janela de contexto de qualquer agente trabalhando neste repositório. Eles devem ser usados com moderação extrema, geralmente apenas para ponteiros de navegação para outros arquivos.
• CODING_STANDARDS.md: este arquivo é lido durante a revisão, não a implementação. Adicione ponteiros de navegação para pastas de documentação se o arquivo de padrões ficar com mais de 1.000 linhas.
• Documentação: use a documentação como arquivos de referência, apontados por outros arquivos. Procure documentação existente antes de escrever nova.
• Skills: use skills para documentação (já que sua descrição vai para a janela de contexto do agente), ou para comandos invocados pelo usuário. Siga o conselho da skill writing-for-agents.