Por que todo repo sério tem um CLAUDE.md, AGENTS.md ou SKILL.md agora? · guilhermealbert

Nos últimos meses apareceu um padrão estranho nos repositórios que estou abrindo: arquivos com nomes tipo CLAUDE.md, AGENTS.md, SKILL.md, llms.txt, DESIGN.md. Uns são do Claude Code, outros do Cursor, outros do Copilot, outros de nenhum tool em específico.

A primeira impressão é que cada ferramenta inventou a própria coisa e virou uma bagunça. Olhando de perto, é o contrário: a indústria está convergindo.

Em dezembro de 2025, a OpenAI doou o AGENTS.md pra Linux Foundation, junto do MCP da Anthropic e do Goose do Block. Tudo sob a Agentic AI Foundation. Um estudo no arXiv já analisou 253 arquivos CLAUDE.md reais. O llms.txt, proposto pelo Jeremy Howard em setembro de 2024, já passou dos 600 sites. SKILL.md virou padrão aberto em agentskills.io, com Claude Code, Codex CLI e Copilot lendo o mesmo formato.

Nada disso é framework. Nada disso é dependência. São arquivos de texto. Markdown puro, às vezes com YAML frontmatter. Convenções que vingam justamente porque qualquer agent e qualquer humano consegue ler.

Como não achei um catálogo decente disso em lugar nenhum, fiz um: awesome-ai-conventions.

O que tem lá dentro:

Arquivos de contexto de projeto: AGENTS.md, CLAUDE.md, MEMORY.md, .cursor/rules/, .aiignore, Memory Bank
Arquivos de prompt: .prompty, .prompt, system_prompt.txt
Skills: SKILL.md e os caminhos padrão por agent
Design: DESIGN.md (o Google Stitch documenta como contraparte visual do AGENTS.md)
Descoberta por LLMs: llms.txt e llms-full.txt
Protocolos: MCP e Agent Cards

Cada entrada tem descrição curta, link pra spec oficial, e pelo menos uma referência real (docs, guia ou paper). Segui o manifesto do awesome e coloquei três critérios pra aceitar PRs: adoção por mais de um time, spec pública, e ser convenção baseada em arquivo ou protocolo aberto (nada de "meu framework").

A pasta examples/ tem um arquivo mínimo de cada convenção no caminho que um projeto real usaria. Útil pra quem quer começar a adotar alguma delas sem caçar pedaço por pedaço na documentação.

Se você trabalha com AI agents no dia a dia e conhece alguma convenção que ficou de fora, abre uma issue ou PR. Se só quer explorar o que já existe antes do próximo frameworkzinho-agent-orchestrator tentar substituir tudo por uma API paga, o repo serve pra isso também.

Repositório: github.com/GuilhermeAlbert/awesome-ai-conventions