tech-debt-tracker

Extract, classify, and persist technical debt from conversations and PR reviews.

1|Updated May 11, 2026
One-click install
npx skills add https://github.com/zeropoint-foundation/ironclaw --skill tech-debt-tracker-zeropoint-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt-tracker
Source: https://github.com/zeropoint-foundation/ironclaw/tree/main/skills/tech-debt-tracker
Command: npx skills add https://github.com/zeropoint-foundation/ironclaw --skill tech-debt-tracker-zeropoint-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect and manage technical debt surfaced in conversations, PR reviews, and planning notes by capturing items, tracking status, and surfacing them for weekly retrospectives.

Core Features & Use Cases

  • Passive detection: silently extract debt mentions from conversations and store as backlog items.
  • PR review scan: catch debt noted in reviews and create actionable items.
  • Backlog management: surface, categorize, and promote debt to commitments when ready to fix.
  • Collaboration-ready: integrates with project folders at projects/commitments/tech-debt/ for persistence.
  • Use Case: During a sprint, debt items like "refactor auth module" are surfaced, logged, and scheduled for a future release.

Quick Start

Instruct the system to track tech debt from recent discussions and PRs.

Frequently Asked Questions about tech-debt-tracker

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

FAQPage Schema
How do I track tech debt from PR reviews and conversations?

Track tech debt by scanning PR reviews and conversations to extract, classify, and persist debt items into a backlog under projects/commitments/tech-debt. It supports passive detection, explicit capture, and PR-review scanning modes.

What is the best way to manage technical debt surfaced during a sprint?

Manage technical debt by logging items like refactor notes during a sprint, categorizing them in the backlog, and optionally promoting them to commitments when ready to schedule for a future release.

Can I passively detect tech debt mentions in team conversations?

Yes, passive detection mode silently extracts tech debt mentions from ongoing conversations and automatically stores them as actionable backlog items for later review.

How do I promote backlog tech debt items to commitments?

Promote backlog tech debt items to commitments using the promotion mode, which transitions categorized debt entries from the projects/commitments/tech-debt/ folder into scheduled commitments.

Does this tech debt tracker require external dependencies or components?

No, the tech debt tracker operates with zero external dependencies or components, relying solely on the local projects/commitments/tech-debt/ directory structure for persistence and management.

When should I not use an automated tech debt tracker?

Avoid using an automated tech debt tracker when conversations lack actionable review context or when debt items require complex manual prioritization beyond standard backlog categorization and promotion workflows.