design-debt-tracker

Parse design-state.md to document and prioritize deferred design issues.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Angusatgithub/Charmera --skill design-debt-tracker-angusatgithub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-debt-tracker
Source: https://github.com/Angusatgithub/Charmera/tree/main/.github/skills/design-debt-tracker
Command: npx skills add https://github.com/Angusatgithub/Charmera --skill design-debt-tracker-angusatgithub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams systematically record, monitor, and prioritize deferred design findings, ensuring design quality and accountability over multiple iterations.

Core Features & Use Cases

  • Living Register: Maintains a comprehensive and persistent record of design debt items in design-state.md.
  • Prioritization and Planning: Facilitates review and selection of debt items to address in upcoming development cycles.
  • Use Case: During sprint planning, the team reviews the current debt register, identifies critical issues deferred from previous critique sessions, and schedules them for resolution.

Quick Start

Use the design debt tracker to review the list of deferred issues before starting a new project iteration.

Frequently Asked Questions about design-debt-tracker

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

FAQPage Schema
How do I track deferred design issues across multiple iterations?

Track deferred design issues by maintaining a persistent living register in a markdown file. This approach systematically records design debt items to ensure quality and accountability throughout iterative design processes.

What is design debt and how does a tracker manage it?

Design debt consists of deferred design compromises accumulated during project development. A tracker manages this debt by documenting findings in a structured record, enabling teams to prioritize and schedule resolutions across review cycles.

How do I prioritize design compromises for an upcoming sprint?

Prioritize design compromises for an upcoming sprint by reviewing your tracked debt register and selecting critical issues deferred from previous critique sessions. This facilitates structured planning and escalation workflows for resolution.

Can I use markdown to document and track project design debt?

Yes, you can use markdown to document project design debt by parsing a design-state file. The tracker requires markdown parsing to maintain structured records and keep a comprehensive log of deferred design findings.

Does the design debt tracker integrate with existing project-management workflows?

The tracker integrates with iterative project-management workflows by supporting review, escalation, and resolution processes. It fits into sprint planning by providing a persistent record of design issues to schedule for development cycles.