Estrutura De Código
filefunc × Hono — o código que um agente lê de uma vez: de 60 para 18 linhas
Refatoramos o Hono, framework real com 23k estrelas, usando filefunc. Todos os 4419 testes passaram. E ao medir — o número de linhas que um agente lê ao abrir um conceito caiu da mediana de 60 para 18, uma redução de 71%. O que importa não é a quantidade de arquivos, mas o 'comprimento do que se lê'.
Agent Operable Codebase
Código fácil de ler para humanos é o mesmo que código fácil de operar para agentes? Não é. Quando um arquivo tem 20 funções, o desempenho do agente cai 30-85%. O escritório deve virar fábrica.
Restrições são contratos
Sem promessas, há caos; promessas em excesso são opressão. Restrições racionais formam a proporção áurea. O princípio do estado de direito aplica-se igualmente ao código e ao conhecimento.
filefunc — um arquivo, um conceito
A unidade de navegação de um agente de código com IA é o arquivo. filefunc é uma convenção de estrutura de código Go e ferramenta CLI que força um conceito por arquivo.