report-debtlisted

# Report Debt Generate a comprehensive technical debt assessment with quantified metrics, prioritized issues, and actionable recommendations. ## Prerequisites Omen CLI must be installed and available in PATH. ## Workflow ### Step 1: Scan for Self-Admitted Debt Run the SATD analysis to find explicit debt markers: ```bash omen -f json satd ``` Captures TODO, FIXME, HACK, XXX, and other debt markers with severity. ### Step 2: Calculate TDG Scores Run the TDG analysis for quality grades: ```bash omen -f json tdg ``` TDG provides A-F grades based on complexity, churn, and health metrics. ### Step 3: Measure Duplication Run the clone detection analysis: ```bash omen -f json clones ``` Calculate duplication ratio and identify clone clusters. ### Step 4: Assess Defect Risk Run the defect prediction analysis: ```bash omen -f json defect ``` Identify files with high predicted defect probability. ### Step 5: Check Complexity Run the complexity analysis: ```bash omen -f json complexity ``` Find functions exceeding complexity thresholds. ## Debt Categories Organize findings by category: | Category | Source | Impact | |----------|--------|--------| | Explicit | SATD markers | Known issues, documented | | Structural | TDG grade D/F | Hard to maintain | | Duplication | Clone ratio > 5% | Maintenance burden | | Risk | Defect probability > 0.7 | Likely to cause bugs | | Complexity | Cyclomatic > 15 | Hard to test/modify | ## Output Format Generate a stakeholder-rea