Contexto: arquivo de regras e MCP
Aula 20 de 26 do curso “Vibe coding”. Grátis, com animações e teste.
O agente esquece tudo
Ontem você explicou ao agente como funciona seu app de treinos. Hoje é uma sessão nova e ele não sabe nada de novo. Contexto é tudo que o agente vê agora: sua mensagem, os arquivos abertos e as instruções. Entre sessões ele normalmente não lembra de nada. A solução é simples: escrever o essencial num arquivo dentro do projeto. O agente lê esse arquivo sozinho ao começar. Ele está à esquerda no esquema.
O AGENTS.md e seus parentes
AGENTS.md é um formato aberto: um arquivo de texto simples na raiz do projeto, ou seja, na pasta principal. Muitos agentes leem esse arquivo. O Claude Code lê o próprio CLAUDE.md, e o Cursor tem seus arquivos de regras. A ideia é a mesma em todos: um guia para alguém novo na equipe. A terminação .md significa Markdown, texto simples com títulos e listas. Dá para manter um arquivo principal e nos outros só apontar para ele.
O que escrever nele
As quatro linhas do esquema são o básico. Projeto: uma frase sobre o que é e para quem. Rodar: o comando que inicia o site no seu computador, por exemplo npm run dev. Testes: o comando de testes, por exemplo npm test. Nunca: chaves no código, commits direto na main. Dá para incluir estilo: “nomes claros, textos em português”. É como o bilhete para quem pega o próximo turno no trampo: curto e direto.
Curto e verdadeiro
Um arquivo de dez telas atrapalha: ele come o contexto e o importante se perde no meio dos detalhes. Um que está errado é pior ainda. Diz npm start, mas o projeto roda com npm run dev? O agente vai errar de novo e de novo. Mudou algo no projeto? Atualize o arquivo ou peça ao agente “atualize o AGENTS.md com o que fizemos”. E nada de chaves ali: o arquivo fica no Git, e o Git lembra de tudo.
MCP: tomadas para o agente
MCP (Model Context Protocol) é um jeito padrão de conectar serviços e ferramentas a um agente. Como o USB: um formato de conector, muitos aparelhos diferentes. À direita do esquema há três plugues. GitHub: o agente lê tarefas e PRs. Banco de dados: olha as tabelas com dados. Navegador: abre seu site e aperta os botões sozinho. Cada conexão dessas se chama servidor MCP.
Conecte com cabeça
Um servidor MCP acessa tudo o que você liberar para ele. Instale só os confiáveis: do próprio serviço ou de projetos conhecidos. Dê o mínimo de permissão: no banco, só leitura e de preferência numa cópia de teste, não nos dados reais dos usuários. A pegadinha: o texto que o agente lê via MCP, como uma página da web, pode esconder comandos para a IA. Por isso as ações arriscadas continuam sendo aprovadas por você.
Teste-se
- Para que serve o arquivo AGENTS.md no projeto?
Resposta certa: O agente lê e aprende as regras do projeto. O agente esquece entre sessões, e o arquivo de regras dá o essencial: o que é o projeto, como rodar, o que é proibido. Chaves ali nunca: o arquivo está no Git. - O que é MCP?
Resposta certa: Um padrão para conectar serviços a um agente. MCP é como um USB para o agente: GitHub, banco de dados, navegador e outras ferramentas se conectam do mesmo jeito. - Você conecta um banco de dados ao agente via MCP. Qual o jeito certo?
Resposta certa: Dar o mínimo de permissão: por exemplo, só leitura. Quanto menos permissão, menor o estrago de um erro do agente ou de um comando escondido. Melhor uma cópia de teste que dados reais.