Biblioteca de capacidades para agentes de IA

O agent-docs, projeto de Sami Honkonen, é uma biblioteca de capacidades para agentes de IA que organiza, em um índice, o que cada agente pode fazer. Em vez de carregar todas as instruções de antemão, o agente lê primeiro o índice (CAPABILITIES.md), decide qual capacidade é relevante para a tarefa e só então abre a documentação específica daquela capacidade. Cada documentação é um arquivo Markdown simples que descreve o que a capacidade é, quando usá-la e como implementá-la. Segundo o autor, o próprio agent-docs é um agente dedicado a manter e atualizar essa biblioteca.

A integração com projetos individuais é feita referenciando o CAPABILITIES.md global a partir do arquivo de configuração de cada projeto (AGENTS.md), de modo que agentes específicos passem a enxergar as mesmas capacidades da biblioteca central. À medida que novas funcionalidades são documentadas e adicionadas ao índice, ficam automaticamente disponíveis para os agentes — um crescimento composto da utilidade ao longo do tempo. Adicionar uma capacidade envolve três passos: escrever a documentação, incluir uma linha no índice e fazer o commit. No momento do artigo, a lista tinha sete entradas.

Limitações: a proposta é apresentada como experimental e depende de manutenção contínua do índice; documentações podem ficar desatualizadas em relação às ferramentas reais; e a eficácia depende de o agente interpretar corretamente o índice e escolher a capacidade certa. Na prática, a proposta funciona mais como um padrão operacional leve do que como substituto de um framework completo.

O artigo de Sami Honkonen apresenta a concepção e a implementação inicial do agent-docs como um índice de capacidades que o agente consulta para decidir quais ações tomar, em vez de carregar todas as instruções de uma só vez. O texto descreve o mecanismo (índice em Markdown, leitura sob demanda, documentação por capacidade) e relata que a lista já continha sete entradas, com um processo simplificado para adicionar novas. Não há evolução de versão a versão nem passagem de rumor a fato além da própria proposta descrita na fonte.

Fonte original: An agent capability library — Sami Honkonen.

Organizar capacidades em um índice consultável tende a facilitar escalabilidade e reúso em sistemas de agentes: o desenvolvedor gerencia de forma mais explícita o que cada agente pode fazer e como, sem reescrever funcionalidades a cada projeto. A leitura sob demanda evita carregar instruções desnecessárias, e a documentação por capacidade reduz duplicação de instruções entre agentes. É relevante sobretudo para quem desenvolve agentes locais e quer um padrão simples e versionável para compartilhar ferramentas e conhecimento.