Estructura De Código
filefunc × Hono — El código que un agente lee de una vez: de 60 a 18 líneas
Refactoricé Hono, el framework real con 23k estrellas, usando filefunc. Los 4419 tests pasaron en su totalidad. Y al medirlo — el número de líneas que un agente lee al abrir un concepto bajó de una mediana de 60 a 18 líneas, un 71% menos. La clave no es el número de archivos sino la 'longitud de lectura'.
Agent Operable Codebase
¿El código fácil de leer para humanos es igual al código fácil de operar para agentes? No lo es. Cuando un archivo tiene 20 funciones, el rendimiento del agente cae 30-85%. La oficina debe convertirse en fábrica.
Las restricciones son contratos
Sin promesas hay caos; con demasiadas promesas hay opresión. Las restricciones razonables forman la proporción áurea. El principio del estado de derecho se aplica igual al código y al conocimiento.