Parte01
O que é o projeto
Duas linhas: o que o sistema faz e a stack principal.
IA no código
O modelo de AGENTS.md que faz a IA seguir o seu padrão
A IA não conhece o seu projeto. O AGENTS.md é um arquivo na raiz do repositório com as regras do projeto: o agente lê antes de mexer no código. Você escreve uma vez e para de repetir o padrão do time em cada prompt.
O caminhoregras no repositórioagente lêcódigo no padrãoreview mais rápido
Quem usa agente com método entrega mais e revisa melhor. Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.
Parte02
Como rodar e testar
Os comandos exatos. Sem eles, o agente não consegue provar que funcionou.
Parte03
Onde fica cada coisa
O mapa das pastas que importam: rotas, regras de negócio e testes.
Mentoria
Metade do modelo. Agora, mire na vaga certa.
Saber colocar um agente no padrão do time já te coloca na frente no primeiro emprego. Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.
Parte04
O padrão do código
Nomes, estilo e tratamento de erro. O que o review do time sempre cobra.
Parte05
O que nunca fazer
Não alterar migrations antigas, não instalar dependência sem perguntar, não mexer no .env.
Parte06
Antes de entregar
Testes e lint passando, e um resumo de 3 linhas do que mudou e como testar.
O modelo pronto para copiar
# AGENTS.md ## Projeto API de pagamentos da loja. Node 20 com TypeScript, Express, Prisma (PostgreSQL) e Jest. ## Como rodar - Instalar: npm install - Subir local: npm run dev (porta 3000) - Testes: npm test - Lint: npm run lint ## Estrutura - src/routes: recebe a requisição e chama o service - src/services: regras de negócio - src/repositories: acesso ao banco (Prisma) - tests/: espelha a pasta src ## Padrão de código - async/await, nunca .then encadeado - Erros com a classe AppError (src/errors) - Nomes de função e variável em inglês - Toda função nova de service ganha teste ## Nunca faça - Não altere migrations já aplicadas: crie uma nova - Não instale dependência sem perguntar - Não leia nem edite o .env - Não mude a API pública sem avisar ## Antes de entregar - Rode npm test e npm run lint: tudo precisa passar - Descreva em 3 linhas o que mudou e como testar
Qual arquivo a sua ferramenta lê
AGENTS.md: Formato aberto, lido por Codex, Cursor, Jules, Gemini CLI e outras ferramentas (lista em agents.md).
CLAUDE.md: Claude Code. Mesmo conteúdo, outro nome de arquivo.
.github/copilot-instructions.md: GitHub Copilot. O Copilot também aceita AGENTS.md.
.cursor/rules: Cursor, para regras por pasta ou por tipo de arquivo.
Como saber se funcionou
1. Peça uma tarefa pequena sem repetir nenhuma regra no prompt.
2. Confira se o agente rodou os testes e o lint sozinho.
3. Confira se o código caiu na pasta certa e no padrão do time.
4. Toda vez que você corrigir o agente no review, vire a correção uma linha nova no arquivo.
5. Mantenha curto: até uma página. Regra que ninguém lê não vale.
O júnior repete o padrão em cada prompt. Quem cresce escreve as regras uma vez.
O júnior explica o projeto de novo em cada prompt e reclama que a IA inventa. Quem cresce escreve as regras uma vez e revisa o diff.
Regra: toda vez que você corrigir o agente no review, vire a correção uma linha nova no arquivo.
Use IA no padrão do time e acelere a sua carreira
Agentes no código são o próximo nível de produtividade. A mentoria acelera esse caminho: plano de estudo para a vaga que você quer, LinkedIn que mostra o seu trabalho e as empresas certas para conversar.