Filefunc
filefunc × Hono — From 60 Lines to 18: Code an Agent Reads in One Pass
I refactored Hono — a production framework with 23k stars — using filefunc. All 4,419 tests passed. Then I measured: the median lines an agent reads to grasp one concept dropped 71%, from 60 to 18. File count isn't the point — read length is.
Agent Operable Codebase
Is code that is easy for humans to read the same as code that is easy for agents to work with? It is not. When a file has 20 functions, agent performance drops by 30-85%. The office must be turned into a factory.
Class 8. Agent Factory — Agent Operable Codebase
20 functions in one file → agent performance drops 30-85%. Split with filefunc, test with tsma.
Constraints Are Contracts
Without agreements there is chaos; with too many there is oppression. Rational constraints strike the golden ratio. The principles of rule of law apply equally to code and knowledge.
filefunc — One File, One Concept
The navigation unit for an AI code agent is the file. filefunc is a Go code structure convention and CLI tool that enforces one concept per file.