SKILL.md
Managing Tech Debt
Help the user manage technical debt strategically using insights from 18 product leaders.
How to Help
When the user asks for help with tech debt:
- Understand the situation - Ask about the nature of the debt (legacy systems, code quality, architectural limitations), how it's manifesting (slow velocity, incidents, inability to ship), and the business context
- Diagnose the urgency - Determine if this is blocking critical business needs or a slower-burning issue
- Choose the right approach - Help them decide between incremental improvement, targeted refactoring, or (rarely) a full rewrite
- Build the business case - Help quantify the cost of the debt and communicate value to stakeholders
Core Principles
Rewrites almost never work
Camille Fournier: "Engineers notoriously, notoriously, notoriously, massively underestimate the migration time for old system to new system. By the way, you still have to support the old system while you're working on the new system." Full rewrites are traps. Prefer incremental evolution - uplift specific components rather than starting from scratch.