managing-tech-debt

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.