Os três artefatos de hoje

• Um AGENTS.md para o repositório do projeto de vocês
• Uma skill que capture um procedimento repetitivo da dupla
• Um servidor MCP mínimo, expondo uma ferramenta só

AGENTS.md, e os seis smells

• Lint Leakage: repetir o que o linter já garante · 62% dos casos
• Context Bloat: arquivo longo demais para ser lido · 42%
• Skill Leakage: ensinar ao agente o que ele já sabe · 35%
• Em 91 de 100 repositórios analisados havia ao menos um

Santos et al., 2026, arXiv:2606.15828

A skill de vocês

• Escolham um procedimento que a dupla repete: revisar PR, subir versão, escrever migração
• Nome e descrição importam mais que o corpo, porque é o que o agente lê primeiro
• Testem: o agente carrega a skill sozinho quando deveria?

O servidor MCP

• Uma ferramenta só, que resolva algo do domínio do projeto de vocês
• Retorno de alto sinal: nomes legíveis, não identificadores opacos
• Descrição escrita como se fosse para alguém que entrou na equipe hoje

Ao fim da aula

• Os três artefatos versionados no repositório
• Entrega da AP2: funcionalidade no repositório da outra dupla, testes e revisão crítica