Toggle Debt
ELI5 — The Vibe Check
Toggle debt is the pile of unused feature flags slowly suffocating your codebase. Every 'if (flag)' branch is cognitive load. Clean them up, or future-you will hate you.
Real Talk
Toggle debt is the technical debt incurred by accumulated, unmaintained feature flags. Each retained flag adds branching complexity, testing permutations, and risk of default-value drift. Distinct from feature-flag rot (silent behavior change), toggle debt is the aggregate weight of all retained flags regardless of whether their behavior has drifted.
When You'll Hear This
"We have 300 flags in this service. Toggle debt is bankrupting us." / "Every sprint should retire at least one flag — that's toggle-debt paydown."
Related Terms
Feature Flag
A feature flag is a toggle that lets you turn features on or off without deploying new code.
Feature Flag Rot
Feature flag rot is when a flag has been sitting around for so long that nobody knows what it does or what breaks when you flip it.
Technical Debt
Technical debt is the coding equivalent of putting things on a credit card.
Toggle Hygiene
Toggle hygiene is the practice of cleaning up feature flags after they've served their purpose.