{"head":{"title":"How to Handle Technical Debt Without Stopping Work","description":"Handle technical debt by making it visible, fixing what slows you down most, and paying it down a little every sprint. Compliance-ready from day one.","canonical":"https://oceanlab.in/questions/how-to-handle-technical-debt"},"crumbs":[{"name":"Home","path":"/"},{"name":"Questions","path":"/questions"},{"name":"How do I handle technical debt?","path":"/questions/how-to-handle-technical-debt"}],"question":"How do I handle technical debt?","answer":["Make it visible, rank it by how much it slows you down or puts you at risk, and pay it down steadily alongside feature work instead of waiting for a big rewrite. Some ",{"href":"/glossary/technical-debt","text":"technical debt"}," is a fair trade for speed; the problem is debt nobody tracks."],"sections":[{"heading":"A practical approach","body":[],"bullets":[["List it: a short register of known debt with where it is and what it costs you."],["Rank it by impact: what slows every change, what causes incidents, what is a security risk."],["Reserve a steady share of each sprint for paying it down."],["Fix debt in the code you are already changing for a feature."],["Add tests before refactoring risky areas."],["Keep dependencies current with small, regular upgrades."]]},{"heading":"When a rewrite is worth it","body":[["Rarely all at once. Rewrites take longer than planned and pause feature work. A gradual replacement, one module or service at a time behind stable interfaces, usually gets the benefit with far less risk."]],"bullets":[]}],"faqs":[{"question":"How do I explain technical debt to non-engineers?","answer":"As interest: each shortcut makes future changes slower and riskier until it is paid back. Show the features or incidents it is slowing down."},{"question":"Is AI-written code more prone to debt?","answer":"It can be if it is accepted without review. Treat AI output like any other code: review it, test it and keep it consistent with the codebase."},{"question":"Can a new team take on a codebase with lots of debt?","answer":"Yes, with a proper handover and an honest assessment first. Expect slower progress at the start."}],"terms":[{"href":"/glossary/technical-debt","label":"technical debt"},{"href":"/glossary/total-cost-of-ownership","label":"total cost of ownership"},{"href":"/glossary/mvp","label":"MVP"}],"tools":[{"href":"/tools/software-maintenance-cost","label":"Software maintenance cost","detail":"Free tool"},{"href":"/tools/sprint-velocity-calculator","label":"Sprint velocity calculator","detail":"Free tool"}],"links":[{"href":"/embedded-engineers","label":"Embedded engineers","detail":"OceanLab engineers working inside your team."},{"href":"/glossary/backlog","label":"Backlog","detail":"Glossary"},{"href":"/glossary/velocity","label":"Velocity","detail":"Glossary"}],"related":[{"href":"/questions/what-does-software-maintenance-cost","label":"What does software maintenance cost?","detail":"Question"},{"href":"/questions/how-to-hand-over-a-software-project","label":"How do I hand over a software project?","detail":"Question"},{"href":"/questions/how-to-migrate-off-no-code","label":"How do I migrate off no-code?","detail":"Question"},{"href":"/compare/ai-agent-vs-workflow-automation","label":"AI agent vs workflow automation","detail":"Comparison"},{"href":"/compare/rag-vs-fine-tuning","label":"RAG vs fine-tuning","detail":"Comparison"},{"href":"/glossary","label":"Glossary","detail":"Every term, in plain words."}],"sources":[],"legal":false,"updatedAt":"2026-10-25"}