tech-debt-tracker
Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.
- License 许可
- MIT
- 所属仓库
- kalash33/kstack
- 最近更新
- 2026-05-20
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- tech-debt-tracker
- description
- Scan codebases for technical debt, score severity, track trends, and generate prioritized remediation plans. Use when users mention tech debt, code quality, refactoring priority, debt scoring, cleanup sprints, or code health assessment. Also use for legacy code modernization planning and maintenance cost estimation.
02 资源文件 17
- 资产文件assets/historical_debt_2024-01-15.json8.0 KB
- 资产文件assets/historical_debt_2024-02-01.json6.4 KB
- 脚本assets/sample_codebase/src/frontend.js14.5 KB
- 脚本assets/sample_codebase/src/payment_processor.py13.5 KB
- 脚本assets/sample_codebase/src/user_service.py9.3 KB
- 资产文件assets/sample_debt_inventory.json7.6 KB
- 参考文档expected_outputs/sample_dashboard_output.json5.2 KB
- 参考文档expected_outputs/sample_prioritization_output.json44.6 KB
- 参考文档expected_outputs/sample_scan_output.json57.0 KB
- 参考文档README.md9.3 KB
- 参考文档references/debt-classification-taxonomy.md10.2 KB
- 参考文档references/debt-frameworks.md13.7 KB
- 参考文档references/prioritization-framework.md10.6 KB
- 参考文档references/stakeholder-communication-templates.md12.6 KB
- 脚本scripts/debt_dashboard.py39.9 KB
- 脚本scripts/debt_prioritizer.py33.9 KB
- 脚本scripts/debt_scanner.py25.7 KB
03 SKILL.md 正文
Tech Debt Tracker
Tier: POWERFUL 🔥
Category: Engineering Process Automation
Expertise: Code Quality, Technical Debt Management, Software Engineering
Overview
Tech debt is one of the most insidious challenges in software development - it compounds over time, slowing down development velocity, increasing maintenance costs, and reducing code quality. This skill provides a comprehensive framework for identifying, analyzing, prioritizing, and tracking technical debt across codebases.
Tech debt isn't just about messy code - it encompasses architectural shortcuts, missing tests, outdated dependencies, documentation gaps, and infrastructure compromises. Like financial debt, it accrues "interest" through increased development time, higher bug rates, and reduced team velocity.
What This Skill Provides
This skill offers three interconnected tools that form a complete tech debt management system:
- Debt Scanner - Automatically identifies tech debt signals in your codebase
- Debt Prioritizer - Analyzes and prioritizes debt items using cost-of-delay frameworks
- Debt Dashboard - Tracks debt trends over time and provides executive reporting
Together, these tools enable engineering teams to make data-driven decisions about tech debt, balancing new feature development with maintenance work.
Technical Debt Classification Framework
→ See references/debt-frameworks.md for details
Implementation Roadmap
Phase 1: Foundation (Weeks 1-2)
- Set up debt scanning infrastructure
- Establish debt taxonomy and scoring criteria
- Scan initial codebase and create baseline inventory
- Train team on debt identification and reporting
Phase 2: Process Integration (Weeks 3-4)
- Integrate debt tracking into sprint planning
- Establish debt budgets and allocation rules
- Create stakeholder reporting templates
- Set up automated debt scanning in CI/CD
Phase 3: Optimization (Weeks 5-6)
- Refine scoring algorithms based on team feedback
- Implement trend analysis and predictive metrics
- Create specialized debt reduction initiatives
- Establish cross-team debt coordination processes
Phase 4: Maturity (Ongoing)
- Continuous improvement of detection algorithms
- Advanced analytics and prediction models
- Integration with planning and project management tools
- Organization-wide debt management best practices
Success Criteria
Quantitative Metrics:
- 25% reduction in debt interest rate within 6 months
- 15% improvement in development velocity
- 30% reduction in production defects
- 20% faster code review cycles
Qualitative Metrics:
- Improved developer satisfaction scores
- Reduced context switching during feature development
- Faster onboarding for new team members
- Better predictability in feature delivery timelines
Common Pitfalls and How to Avoid Them
1. Analysis Paralysis
Problem: Spending too much time analyzing debt instead of fixing it. Solution: Set time limits for analysis, use "good enough" scoring for most items.
2. Perfectionism
Problem: Trying to eliminate all debt instead of managing it. Solution: Focus on high-impact debt, accept that some debt is acceptable.
3. Ignoring Business Context
Problem: Prioritizing technical elegance over business value. Solution: Always tie debt work to business outcomes and customer impact.
4. Inconsistent Application
Problem: Some teams adopt practices while others ignore them. Solution: Make debt tracking part of standard development workflow.
5. Tool Over-Engineering
Problem: Building complex debt management systems that nobody uses. Solution: Start simple, iterate based on actual usage patterns.
Technical debt management is not just about writing better code - it's about creating sustainable development practices that balance short-term delivery pressure with long-term system health. Use these tools and frameworks to make informed decisions about when and how to invest in debt reduction.
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reacti...
zoom-automation
Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.
zoho-crm-automation
Automate Zoho CRM tasks via Rube MCP (Composio): create/update records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.
zod-validation-expert
Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.
zeroize-audit
Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C/C++/Rust code handling secrets, keys, passwords, or other sensitive data.
zendesk-automation
Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.