Skills & Agentes IA
Cursor / Copilot
Gerador de AGENTS.md: a Memória Permanente do Seu Repositório para IAs
A IA varre o repo e escreve o AGENTS.md/CLAUDE.md: comandos reais, convenções deduzidas do código e armadilhas — em no máximo 120 linhas.
0cópias
0joinhas
0favoritos
O prompt
Atue como um Arquiteto de Contexto para agentes de código. Analise este repositório e crie o arquivo AGENTS.md na raiz (funciona como CLAUDE.md no Claude Code e .cursor/rules no Cursor). Descubra sozinho, inspecionando o repositório: 1. Comandos exatos: instalar, rodar dev, build, testar, lint, typecheck (leia package.json/Makefile/arquivos de CI). 2. Arquitetura: onde vive o código, rotas, modelo de dados, organização de pastas. 3. Convenções REAIS do código: nomenclatura, padrão de componentes, tratamento de erro — deduza lendo 5-10 arquivos representativos, não invente. 4. Armadilhas que eu descobriria só quebrando algo: variáveis de ambiente obrigatórias, como rodar migrations, serviços externos necessários. Regras do arquivo: - Máximo 120 linhas. Para cada linha, pergunte: 'se eu remover isso, o agente comete um erro?' Se não, corte. - Nada que o agente deduz sozinho lendo o código — não documente o óbvio. - Comandos copiáveis e caminhos de arquivo reais, nunca hipotéticos. - Termine com a seção 'Regras não-negociáveis' (ex.: nunca commitar direto na main; sempre rodar typecheck antes de finalizar). Mostre o arquivo final e, abaixo dele, explique em 1 frase por que cada seção está lá.
Como usar
- Rode dentro de um agente com acesso ao repo (Claude Code, Cursor, opencode) na raiz do projeto.
- Revise linha por linha: o maior risco do AGENTS.md é a barriga — arquivo gordo faz o agente IGNORAR suas instruções reais (alerta da própria Anthropic).
- Teste de qualidade: abra uma sessão nova e pergunte 'como rodo os testes?'. Se o agente acerta sem você dizer nada, o arquivo funciona.
- Mantenha vivo: ao fim de cada sessão em que o agente errou por falta de contexto, adicione UMA regra curta (padrão 'post-mortem da sessão').
- Use o mesmo arquivo como onboarding para devs humanos — as duas audiências se beneficiam.
Exemplo de saída
AGENTS.md de 74 linhas para um monorepo Next.js + Fastify: tabela de comandos (pnpm dev, pnpm test:unit, pnpm db:migrate), mapa de 6 pastas, 3 convenções deduzidas (hooks em useX, erros via Result type), armadilha 'DATABASE_URL precisa de schema promptsalvo' e 4 regras não-negociáveis incluindo 'rode typecheck antes de declarar pronto'.