Filefunc
filefunc × Hono — 에이전트가 한 번에 읽는 코드를 60줄에서 18줄로
별 23k짜리 실전 프레임워크 Hono를 filefunc으로 리팩토링했다. 테스트 4419개 전부 통과. 그리고 측정해보니 — 에이전트가 개념 하나를 read할 때 읽는 코드가 중앙값 60줄에서 18줄로 71% 줄었다. 파일 개수가 아니라 '읽는 길이'가 핵심이다.
Agent Operable Codebase
사람이 읽기 좋은 코드와 에이전트가 작업하기 좋은 코드는 같은가? 같지 않다. 파일 하나에 함수 20개가 있으면 에이전트 성능이 30~85% 떨어진다. 사무실을 공장으로 바꿔야 한다.
제 8강. 에이전트의 공장 — Agent Operable Codebase
파일 하나에 함수 20개 → 에이전트 성능 30~85% 하락. filefunc로 쪼개고 tsma로 테스트한다.
제약은 계약이다
약속이 없으면 혼돈이고, 약속이 과하면 억압이다. 합리적 제약은 황금비를 이룬다. 법치주의의 원리가 코드와 지식에 동일하게 적용된다.
filefunc — 파일 하나에 개념 하나
AI 코드 에이전트의 탐색 단위는 파일이다. 파일 하나에 개념 하나를 강제하는 Go 코드 구조 컨벤션이자 CLI 도구.