Структура Кода
filefunc × Hono — код, читаемый агентом за один раз: с 60 строк до 18
Мы отрефакторили реальный фреймворк Hono (23k звёзд) по правилам filefunc. Все 4419 тестов прошли. А измерения показали: медиана строк, которые агент читает ради одной концепции, упала с 60 до 18 — минус 71%. Дело не в количестве файлов, а в длине чтения.
Agent Operable Codebase
Код, удобный для чтения людьми, и код, удобный для работы агентов — одно и то же? Нет. Когда в файле 20 функций, производительность агента падает на 30-85%. Офис надо превратить в фабрику.
Ограничения — это контракты
Без обещания — хаос, обещание сверх меры — угнетение. Разумное ограничение образует золотое сечение. Принцип верховенства закона одинаково применим к коду и к знанию.
filefunc — один файл, одна концепция
Единица навигации AI-агента по коду — это файл. Конвенция структурирования Go-кода и CLI-инструмент, который принудительно ограничивает один файл одной концепцией.