improvement-tracking

Track code improvement ideas and debt in a PDCA-driven workflow.

1|Updated Jun 15, 2025
One-click install
npx skills add https://github.com/shioki/Cursor-Knowledge-Management-System --skill improvement-tracking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improvement-tracking
Source: https://github.com/shioki/Cursor-Knowledge-Management-System/tree/main/templates/.cursor/skills/improvement-tracking
Command: npx skills add https://github.com/shioki/Cursor-Knowledge-Management-System --skill improvement-tracking

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps engineering teams systematically capture, track, and close improvement opportunities, residual debt, and refactoring progress to support continuous quality improvement.

Core Features & Use Cases

  • Improvement capture: Record proposals, decisions, and outcomes with a clear PDCA cycle.
  • Progress tracking: Maintain a living log of implemented improvements and their impact using the templates in references/.
  • Automation support: Use scripts/add-improvement.sh to add new entries and automate status updates.

Quick Start

Run the add-improvement script with a descriptive title to create a new improvement entry.

Frequently Asked Questions about improvement-tracking

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

FAQPage Schema
How do I track technical debt and refactoring progress systematically?

To track technical debt and refactoring progress, use a PDCA-driven workflow to capture proposals, record implementation outcomes, and maintain a living log of improvements. This enforces structured YAML frontmatter entries and provides shell scripts for automated tracking.

What is the PDCA cycle for continuous code quality improvement?

The PDCA cycle for continuous code quality improvement is a structured loop of Plan, Do, Check, and Act. It helps engineering teams systematically capture improvement opportunities, implement refactoring changes, track residual debt, and evaluate performance impact.

How do I automate logging new code improvement ideas in a software repository?

You can automate logging new code improvement ideas by running a dedicated shell script entry point with a descriptive title. This automatically creates new structured improvement entries and enforces required YAML frontmatter metadata for your tracking log.

Can I use this improvement tracking workflow for an existing software project?

Yes, you can apply this improvement tracking workflow to existing software projects and repositories needing transparent improvement histories. It requires no external dependencies and integrates into your current environment using provided templates and shell scripts.

What's the best way to maintain a transparent history of iterative refactoring?

The best way to maintain a transparent history of iterative refactoring is to document proposals, decisions, and outcomes in structured templates. This creates a living log that supports continuous quality improvement and tracks the impact of each change.

Are there limitations to tracking code improvements with shell scripts and YAML frontmatter?

A limitation of tracking code improvements with shell scripts and YAML frontmatter is that it requires manual execution to add entries and lacks dependency integration. It serves as a structured logging mechanism rather than an automated static analysis tool.