Biblioteca de capacidades para agentes

Essa biblioteca de capacidades não é um framework nem uma API, é um padrão operacional minimalista para agentes locais baseados em LLMs. Funciona como um índice dinâmico em Markdown, onde cada entrada representa uma habilidade concreta (ex.: 'browser automation', 'MCP server pessoal') com três elementos essenciais: contexto de uso ('quando chamar'), descrição funcional ('o que faz') e link para documentação detalhada ('como usar'). O agente não carrega tudo na memória; ele consulta o índice primeiro, faz uma decisão de roteamento e só então carrega o documento específico, otimizando latência e custo computacional.

O modelo se afasta da abordagem monolítica de 'agentes com todas as ferramentas embutidas'. Aqui, a inteligência está na organização, não na carga. A atualização é colaborativa com IA: o próprio agente 'agent-docs' mantém a biblioteca, gerando e revisando os arquivos .md. Isso transforma a documentação em código executável, não um artefato estático, mas parte ativa do fluxo de trabalho.

Desenvolvedores que rodam LLMs locais (como ophi, ollama ou LM Studio) costumam criar agentes pontuais, mas sem reusabilidade entre projetos. Essa biblioteca resolve isso com um sistema de descoberta baseado em convenção: basta incluir uma referência ao CAPABILITIES.md no AGENTS.md de qualquer projeto, e o agente herda imediatamente sete (ou mais) capacidades testadas. Não exige SDK, nem integração com orquestradores, só caminhos de arquivo e leitura condicional de Markdown.

É um passo prático rumo à 'infraestrutura como documentação': cada nova ferramenta configurada (um VM em exe.dev, um servidor MCP local) vira uma entrada reutilizável, não um script isolado. Para quem constrói agentes em casa, isso reduz a curva de manutenção e aumenta a confiabilidade, porque o que é documentado de forma estruturada tende a ser usado de forma consistente.