Deduplicate by intent, not by appearance. Similar text with different reasons to change should stay separate.
Workflow
-
Identify the duplicated code and every caller.
-
Name the business or technical intent of each copy.
-
Compare future change reasons, owners, invariants, and release cadence.
-
Deduplicate only when the shared abstraction can be named honestly and will change for one reason.
-
If intent differs, keep duplication or extract smaller mechanical helpers that do not pretend to be domain concepts.
Decision Matrix
- Same text, same intent: merge.
-
Same text, different intent: keep separate.
-
Different text, same intent: consider unifying.
-
Different text, different intent: do not merge.
Detailed Reference
For non-trivial implementation, review, or refactoring work, read references/details.md before giving final guidance. It contains the detailed rules, examples, smells, and migration notes that do not belong in the short invocation body.
Output
Return the intent comparison, decision, proposed abstraction name if any, and risks of coupling.