tech-debt-log

Log and prioritize technical debt items with impact and effort details.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/devmuslim/pdm-skills --skill tech-debt-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt-log
Source: https://github.com/devmuslim/pdm-skills/tree/main/pdm-cross-team-coordination/skills/tech-debt-log
Command: npx skills add https://github.com/devmuslim/pdm-skills --skill tech-debt-log

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of hidden technical debt that slows down delivery velocity and introduces risk by providing a structured way to log, prioritize, and negotiate time for its resolution.

Core Features & Use Cases

  • Structured Logging: Maintain a log of technical debt items with details on description, area, impact, effort, priority, date, and owner.
  • Priority Classification: Categorize tech debt based on its impact on delivery and potential for failure or security issues.
  • Negotiation Framework: Provides a method to negotiate time for tech debt reduction, such as the "20% rule" for sprint capacity.
  • Use Case: A team is experiencing slow sprint velocity. They use this skill to log recurring technical issues identified in retrospectives, prioritize them, and present a business case to stakeholders for allocating dedicated time to address the most critical items.

Quick Start

Use the tech-debt-log skill to create a new entry for 'Auth service has no unit tests' in the 'Auth' area, noting it has a 'High' impact on delivery and requires '5 days' effort.

Frequently Asked Questions about tech-debt-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track technical debt to make delivery risks visible?

You can track technical debt by maintaining a structured log that records item descriptions, impacted areas, delivery impact, required effort, priority, date, and owner. This makes hidden delivery risks visible and facilitates stakeholder negotiation for resolution time.

What is the best way to prioritize technical debt during sprint planning?

Prioritize technical debt by classifying items based on their impact on delivery velocity and potential for failure or security issues. This risk-based classification helps engineering leads determine which code quality issues require immediate sprint capacity.

How do I negotiate time for technical debt reduction with stakeholders?

Negotiate time for technical debt reduction by applying a structured framework like the 20% rule, which allocates a fixed percentage of sprint capacity to address prioritized debt items, ensuring system maintainability without halting feature delivery.

Can I use a technical debt log for recurring issues identified in retrospectives?

Yes, a technical debt log is designed to capture recurring code quality issues identified in retrospectives. Logging these items with their delivery impact provides a clear business case for allocating dedicated development time.

What criteria define a technical debt item in a structured log?

A technical debt item is defined by its negative impact on delivery velocity, potential to introduce system failure or security issues, required remediation effort, affected code area, assigned owner, and the date it was logged.