How to Create a Tech Debt Tracker in Linear
Linear's label system, triage workflow, and Cycle-based sprint planning give engineering managers the tools to track tech debt alongside feature work without creating a separate tool. The key is building a system that makes debt visible and prioritizable — not just a place to file it and forget it.
This guide covers how to set up tech debt tracking in Linear, how to use labels and projects to organize debt by impact, and how to ensure debt consistently makes it into Cycles rather than aging in the backlog.
Step-by-step guide
Create a tech debt label taxonomy
In Linear, go to Settings > Labels. Create a parent label "Tech Debt" and child labels for debt categories: Tech Debt/Architecture, Tech Debt/Performance, Tech Debt/Security, Tech Debt/Tests, Tech Debt/Dependencies, Tech Debt/Documentation. Every tech debt issue gets the parent label plus one category label. This allows filtering: show all tech debt (parent label) or just performance debt (child label).
Create a Tech Debt backlog project
Create a Linear Project called "Tech Debt Backlog" with no target date. This is the holding area for identified debt that has not been sprint-planned yet. Add all triaged tech debt issues to this project. Create a filtered view of this project sorted by Priority (Urgent/High first) — this is your monthly debt review view that the EM reviews with the team to select debt for the next Cycle.
Require impact and effort on every debt issue
Write a team convention: no tech debt issue enters the backlog without a description that includes Current state (what the code does now), Problem (what cost this creates — slower builds, repeated bugs, security risk), Desired state (what the fix looks like), and Estimate (story points). Issues without this context get bounced back to the creator. Issues without actionable descriptions are not issues — they are complaints.
Allocate a debt budget in each Cycle
At Cycle planning, reserve 20% of total story points for tech debt. Pull the top-priority items from the Tech Debt Backlog project into the Cycle. Linear's Cycle planning view shows total points per assignee so you can validate the 20% allocation. After each Cycle retrospective, report "debt points cleared vs debt points added this Cycle" — this metric shows whether the team is reducing or growing its debt load.
Link debt issues to affected features
Use Linear's "Blocking" relationship to link tech debt issues to the feature issues they affect. When the payments service debt blocks the checkout redesign feature, that relationship is visible in Linear's dependency graph. This surfaces debt organically during feature planning — when an EM opens the checkout redesign, the blocking debt issues appear immediately, making the case for prioritizing the paydown.
Common mistakes
Storing tech debt only in code comments or a Notion doc
TODO comments in code and debt docs in Notion are invisible to sprint planning. Tech debt that lives outside Linear cannot be Cycle-planned, estimated, or tracked. Every identified debt item should exist as a Linear issue within 24 hours of identification — comments and docs can reference the issue number, but the issue is the record of truth.
No clear ownership of the debt backlog
A tech debt backlog without a DRI becomes a dumping ground. Assign one engineer (rotating monthly or quarterly) as debt backlog owner: they triage new items, close duplicates, prompt engineers to add missing context, and present the top-priority debt at monthly EM reviews. Without ownership, debt backlogs grow but never shrink.
Tracking debt separately from feature work
If tech debt lives in a separate Linear team or project that is not in the sprint planning view, it will never compete for sprint capacity. Keep debt in the main team backlog so it is visible during Cycle planning. The 20% budget is only enforceable if debt issues are in the same planning view as feature issues.
Tips
Create a Linear view filter for "Tech Debt added last 30 days" — presenting this at monthly EM reviews shows debt accumulation rate and creates accountability for teams that are accruing debt faster than clearing it
Use Linear's project update feature to post a monthly debt health update to the Tech Debt Backlog project: items added, items cleared, current balance. This creates a longitudinal record of debt trends.
When a bug is fixed by working around a debt issue (rather than fixing the root cause), log a tech debt issue for the root cause immediately and link it to the workaround commit. This prevents "temporary" workarounds from becoming permanent.
How Vantage helps
Linear tracks tech debt as discrete issues. Vantage connects those debt issues to the product roadmap: when a PRD requires building on a component with known debt, Vantage surfaces the relevant debt items so the EM and PM can decide to pay down the debt before or alongside the new feature. This prevents feature shipping on top of known debt that degrades quality and velocity.