Justifying Refactoring — Vocabulary and Business Language
Learn vocabulary for justifying refactoring decisions: business case, risk language, timing, and return on investment.
0 / 5 completed
1 / 5
What is the 'boy scout rule' in refactoring vocabulary?
The Boy Scout Rule (Robert C. Martin): 'Always leave the campground cleaner than you found it.' Applied to code: each commit should leave the code slightly better — rename a variable, extract a method, remove a comment. Incremental improvement avoids the need for large, risky refactoring projects.
2 / 5
How do you justify a refactoring to non-technical stakeholders?
Non-technical stakeholders respond to business impact, not code quality. Effective justification: 'Feature X is taking 3x longer than it should because of [module]. Refactoring it will reduce future feature costs in this area by an estimated 60% and reduce the risk of [bug type].' Specific, measurable, business-outcome framing.
3 / 5
What is 'opportunistic refactoring' in software engineering vocabulary?
Opportunistic refactoring (Fowler) means improving code while working in an area for another reason — 'I'm adding this feature anyway, let me extract this method while I'm here.' It distributes refactoring effort across the development flow and avoids the need for large dedicated refactoring sprints.
4 / 5
What does 'strangler fig pattern' mean in refactoring vocabulary?
Strangler Fig (Fowler, inspired by the strangler fig tree): build the new system alongside the old, routing new functionality to the new system while old functionality gradually migrates. The old system is 'strangled' until it handles nothing and can be deleted. Used for high-risk legacy migrations.
5 / 5
What is 'refactoring debt' and how does it differ from 'technical debt'?
Technical debt is broader: rushed decisions, missing tests, poor architecture. Refactoring debt is the tracked, acknowledged subset: 'We know Module X needs to be extracted into a service — it's in the backlog.' Making debt visible in a debt registry (JIRA epic, ADR) separates it from vague technical debt conversations.