Most technical debt reports fail for a simple reason: they list concerns, but they do not create decisions.
A useful finding should help an engineer understand the risk and help a leader understand whether the fix deserves time. That requires more than a severity label.
Here is a practical structure for a technical debt finding that can move from report to remediation.
1. Stable Identity
Every finding needs an identity that survives small code changes.









