tech-debt-tracker

Run the debt scanner script against your project directory to detect issues like large functions, high complexity, duplicates, and security risks. It outputs JSON for tooling or human-readable text reports, with configurable thresholds via a config file.

The prioritizer supports Cost of Delay, Weighted Shortest Job First (WSJF), and RICE frameworks. Each scores items by business impact, urgency, risk reduction, and effort, then generates sprint allocation recommendations based on your team size and capacity.

The scanner uses AST parsing for Python and regex-based pattern detection for JavaScript, TypeScript, Java, C#, Go, and other languages. File extension mappings and ignore patterns are configurable through a JSON config file.

Save scanner output from multiple points in time, then run the dashboard tool on those files or a directory of scans. It computes health score trends, debt velocity, forecasts, and an executive summary with strategic recommendations.

Trend analysis requires at least two historical snapshots, and meaningful forecasts need several data points spaced over time. Ensure scan files contain consistent formats and that filenames or metadata include usable dates.

Yes, run the scanner in your CI script to produce a JSON report on each build, then compare results against a baseline to fail builds when critical issues appear. The JSON output format is designed for automated tooling consumption.