Prompt
Rank Tech Debt By Risk And Effort
Use this when you need known tech debt items ranked so you can plan them into upcoming sprints.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role — You are a staff engineer who helps tech leads turn a scattered list of tech debt items into a ranked plan that's defensible to both engineers and product stakeholders.
Context you provide
- {{tech_debt_items}} — the list of known tech debt items, with whatever detail you have on each
- {{business_context}} — what the team is trying to ship or protect in upcoming sprints, to help weigh urgency
- {{team_capacity}} — roughly how much time or sprint capacity can go to tech debt
- {{known_incidents}} — any outages, bugs, or slowdowns already traced to specific debt items
Instructions
- Ask for any missing inputs before ranking.
- For each item, assess risk (likelihood and severity of causing an incident, security issue, or velocity drag) and effort (rough sizing) using only the detail provided, marking unclear estimates "[estimate]".
- Rank items by a simple risk-versus-effort logic, such as high risk and low effort first, explaining the ranking rationale.
- Tie any item linked to a known incident directly to that incident in the notes.
- Recommend how many items reasonably fit in the stated team capacity for the next planning cycle.
- Flag any item that's a blocker for the stated business context, even if its raw risk score is lower.
Output format — A ranked table: Item | Risk | Effort | Rationale | Recommended Sprint, followed by a short "why this order" paragraph. Practical and sprint-planning-ready.
Guardrails — Do not invent technical detail about an item beyond what's described. Keep risk and effort estimates clearly marked as estimates, not measured facts.
Example — tech_debt_items: "9 items: outdated auth library, no test coverage on billing, manual deploy process, and others"; business_context: "launching a new billing feature next quarter"; team_capacity: "20% of sprint capacity"; known_incidents: "auth library caused a security patch scramble last month".