How a 1,920-line file turned into 410 lines, why "it works" was a lie twice, and why the fix wasn't a smarter model — it was a gate that doesn't trust anyone, including me.
The setup
I maintain YouMindAG, an open-source CLI (npx youmindag) that injects project context — architecture, dependencies, rules, DB schema — into AI coding tools like Claude Code, Cursor, opencode, and Copilot, so they don't have to rediscover your codebase from scratch every session.
By v2.7.0, the CLI's entrypoint, bin/run.mjs, had grown to 1,920 lines. One file. Install logic, upgrade logic, seventeen subcommands, vault population, dev-server wrapping, AST-based tracing — all of it, flat.
I did what you're supposed to do: I modularized it. With an AI coding agent doing the heavy lifting and me reviewing, I split it into lib/ — one file per concern, one file per command family. By v2.9.0, bin/run.mjs was down to 410 lines, functioning only as an orchestrator.
