--- name: tech-debt-tracker-d695e4640c01 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. --- # 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: 1. **Debt Scanner** - Automatically identifies tech debt signals in your codebase 2. **Debt Prioritizer** - Analyzes and prioritizes debt items using cost-of-delay frameworks 3. **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) 1. Set up debt scanning infrastructure 2. Establish debt taxonomy and scoring criteria 3. Scan initial codebase and create baseline inventory 4. Train team on debt identification and reporting ### Phase 2: Process Integration (Weeks 3-4) 1. Integrate debt tracking into sprint planning 2. Establish debt budgets and allocation rules 3. Create stakeholder reporting templates 4. Set up automated debt scanning in CI/CD ### Phase 3: Optimization (Weeks 5-6) 1. Refine scoring algorithms based on team feedback 2. Implement trend analysis and predictive metrics 3. Create specialized debt reduction initiatives 4. Establish cross-team debt coordination processes ### Phase 4: Maturity (Ongoing) 1. Continuous improvement of detection algorithms 2. Advanced analytics and prediction models 3. Integration with planning and project management tools 4. 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. --- Source attribution: 420company Original project: https://github.com/420company/artemis/blob/6fcd9f8e3045e30712e24a177f6d8d63d06cbb5d/skills/tech-debt-tracker/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 420.COMPANY This software is open source and free for everyone. Fork it. Improve it. Make it yours. Pull requests, ideas, and contributions are always welcome. https://github.com/420company/artemis --- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: 420company Original project: https://github.com/420company/artemis/blob/6fcd9f8e3045e30712e24a177f6d8d63d06cbb5d/skills/tech-debt-tracker/SKILL.md Attribution basis: Source repository record Fields of work: Development & Engineering, Product Management Roles: Backend Developer, DevOps / SRE, Product Manager, QA / Test Engineer, Technical Product Manager Specialties: Backend, DevOps Tools: Tool not specified Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 53dcd299481b914ffa8e062575ec1068688bc64d582dc4fcb1002c9bdee62988