Refactor Tax
ELI5 — The Vibe Check
Refactor tax is the extra work every feature costs because you're simultaneously refactoring underlying code. Each PR becomes 30% larger and 50% riskier. Skip paying it and you get a tech-debt snowball instead.
Real Talk
Refactor tax is the overhead added to feature work during an active refactor — typically larger PRs, slower velocity, and higher review complexity. Teams should either accept the tax explicitly (slower quarters while cleaning up) or isolate refactors behind feature flags to keep feature work independent.
When You'll Hear This
"Feature velocity is down 30% — that's the refactor tax." / "Box the refactor inside a flag so we don't pay the tax on unrelated PRs."
Related Terms
Feature Flag
A feature flag is a toggle that lets you turn features on or off without deploying new code.
Refactor
Refactoring is cleaning and reorganizing your code without changing what it does — like tidying your room without throwing anything away.
Refactor Fatigue
Refactor fatigue is when your team has refactored the same module four times in a year and nobody wants to touch it again.
Technical Debt
Technical debt is the coding equivalent of putting things on a credit card.