Boffin stops AI coding agents from renovating your codebase
You ask for a 15-line fix. The agent comes back with a 500-line renovation. Boffin (npm: boffinit) exists to prevent that.
It’s a staff-engineer control layer for AI coding agents. Before an edit, it routes the architectural constraints relevant to the specific file being touched. After the edit, it requires verification proportional to the size of the change. The comparison to a static AGENTS.md is intentional: a repo-wide rules block treats every file the same. Boffin does not.
What the case studies show
Three guided refactors on real open-source codebases are published as reproducible case studies:
- DuckDB (C++): +17 / -17 lines; 2,104 assertions across 8 test files passed; continuation and recovery paths preserved.
- FastAPI (Python): +16 / -33 lines; 49 tests passed; no public API change.
- LangChain (Python): sync/async boundary preserved; 4 tests passed.
The developer notes these are reproducible case studies, not a controlled A/B benchmark.
️ Supported agents and profiles
One npm package covers Cursor, Claude Code, Codex, and OpenCode. Three cleanup profiles are available: lite (smallest useful change), full (balanced default), and max (strongest cleanup pressure). Every profile keeps the same correctness floor: trust-boundary validation, data-loss prevention, security, and accessibility requirements all stay on regardless of profile. There is no off profile.
Worth noting
Boffin does not sandbox processes, filter shell commands, or restrict filesystem or network access. It guides architectural decisions in generated code. It also does not replace your tests or your review process. It tells the agent which contracts deserve attention before the edit lands. Requires Node.js 18 or newer. MIT licensed. Constraint packs are GPG-signed and readable before install.
I’m founder of BizStack at Cagri Sarigoz LLC and a passionate advocate for entrepreneurs.
With over 14 years in tech, marketing, and AI, including my role as Head of SEO at CitizenShipper and co-founder of TaleBot at Intale AI, I’m dedicated to sharing genuine, useful product insights and tips.
At BizStack, I aim to cut through the digital noise to provide clear, actionable advice.
And more than all else, I’m a father to a (always) little girl and a husband.
Contact me at [email protected] for assistance.
