Audit your repo against the ten reasons

Companion to 10 reasons why your vibe coded app won't scale · Farouk Umar

The series names ten failure modes. This is the part you can run — a free, open-source kit that checks your own repo against all ten and writes an evidence-first report: file:line, not vibes. It's on GitHub, MIT licensed, and you should read it before you run it — the install script tells you exactly what it does and what leaves your machine.

Quick install

One command runs an interactive session: it detects your stack and your AI CLI, drives it through the ten reasons, and writes the report.

curl -fsSL https://github.com/papaonlegs/wont-scale/releases/latest/download/install.sh | sh

Claude Code plugin

Prefer it as a plugin inside Claude Code:

/plugin marketplace add papaonlegs/wont-scale
/plugin install wont-scale@wont-scale
/first-audit

Plain terminal wizard

No AI required — ten questions, a config file, a tailored report:

git clone https://github.com/papaonlegs/wont-scale.git
cd wont-scale && npm install
node dist/first-audit.js /path/to/your-app

Or just browse the kit — every reason is a module with the checks, the fix in priority order, and the real incidents behind it.

Want it in your inbox instead?

Tell me what's actually breaking and I'll send the commands above plus a note on your specific situation.

Book a call