Recapitulação e Prática
Principais conclusões
- Um bom ambiente de trabalho dá à IA contexto, um ciclo de feedback rápido e a possibilidade de desfazer barato — a configuração é o multiplicador, muitas vezes mais do que o próprio modelo.
- Um arquivo de contexto (AGENTS.md / CLAUDE.md) é a coisa de maior alavancagem que você pode escrever: regras concretas, "não faça" enfáticos e ponteiros para exemplos.
- Faça do controle de versão um reflexo — commits pequenos, leia o diff, use branches para trabalho arriscado — para que nada do que a IA faz seja verdadeiramente irreversível.
- Mantenha o ciclo curto e deixe o agente fechá-lo: editar, rodar, ler a falha, corrigir. Realimente diagnósticos (, lint, verificação de tipos) de volta para a IA.
- Coloque uma jaula em toda paga com um teto rígido e um estrangulamento, mantenha segredos fora do repositório e use um harness para transformar verificações de segurança em algo que a IA não possa pular.
Experimente
Abra qualquer projeto em que você esteja trabalhando (ou monte um vazio) e escreva à mão um primeiro rascunho de AGENTS.md: o que é o projeto, o stack de tecnologia, os comandos exatos para rodar dev/test/lint, três convenções reais e pelo menos dois "não faça" enfáticos (por exemplo, "nunca leia ou imprima o conteúdo de .env", "não adicione dependências sem avisar antes"). Depois peça à sua ferramenta de IA para fazer uma mudança trivial e observe se ela respeita o arquivo. Cada vez que ela fizer algo que você não queria, adicione ou refine uma linha. Você está ajustando a sala, não apenas o código.
do capítulo
Read my project and help me write a concise AGENTS.md context file for it.
First, inspect the repo and tell me:
- the tech stack and versions you detect
- the commands for install / dev / test / lint / build
- the layout and where the entry point is
Then draft an AGENTS.md with these sections: What this is, Tech stack,
Commands, Conventions, and Don'ts. Be specific and concrete (name the
exact libraries and rules, not "follow our conventions"). State the don'ts
as loudly as the do's, and point to one existing file as a style example.
Keep it under ~40 lines — I'll prune from there.