execute-tech-debt-plan

Executes tech-debt plan documents end-to-end with automatic state management from New to Complete.

Updated May 2, 2024
One-click install
npx skills add https://github.com/cman131/EatSomethingSourWhenYoureTired --skill execute-tech-debt-plan-cman131
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: execute-tech-debt-plan
Source: https://github.com/cman131/EatSomethingSourWhenYoureTired/tree/main/.claude/skills/execute-tech-debt-plan
Command: npx skills add https://github.com/cman131/EatSomethingSourWhenYoureTired --skill execute-tech-debt-plan-cman131

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tech-debt plan documents often sit untouched or get abandoned mid-implementation, leaving their state unclear. This Skill drives a plan document through its full lifecycle, tracking state transitions (New → InProgress → Complete) and delegating the actual fix to an implementation workflow. ## Core Features & Use Cases - Automatic Plan Discovery: Finds all tech-debt docs marked New under docs/tech-debt/ when no path is given, and lets you pick one interactively. - State Guard & Recovery: Detects interrupted runs (state stuck at InProgress) and offers resume or restart options; requires confirmation before re-running completed plans. - Delegated Implementation: Hands off the fix to the superpowers workflow with git worktree isolation, then verifies final state, file relocation to docs/completed-tech-debt/, and commits as a safety net. - Use Case: You have a backlog of tech-debt plans in docs/tech-debt/. Run this Skill, select a plan, and it marks it InProgress, commits the claim, implements the fix in an isolated worktree, merges locally, and archives the doc as Complete. ## Quick Start Ask the AI to execute the tech-debt plan at docs/tech-debt/ranked-league/ranked-season-hardcoded-90-days.md, or simply ask it to pick and run any New tech-debt plan.

Frequently Asked Questions about execute-tech-debt-plan

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

FAQPage Schema
How do I run a tech-debt plan document to completion?▼

Invoke the Skill with the path to a plan under docs/tech-debt/, or with no argument to browse all plans marked New. It flips the state to InProgress, commits and pushes that change, then delegates implementation to the superpowers workflow.

What happens if a tech-debt plan run was interrupted?▼

If the document state is InProgress when you rerun the Skill, it warns that a prior run may have been interrupted and asks whether to resume from where it left off or restart from scratch. Either choice proceeds with the workflow.

Does this Skill implement the tech-debt fix itself?▼

No. It only manages the plan document's state and lifecycle. The actual implementation is delegated to the superpowers:using-superpowers Skill, which uses git worktrees, TDD, and other workflows to complete the fix.

What format must a tech-debt plan document follow?▼

The markdown file needs a ## State section containing exactly one of New, InProgress, or Complete, plus sections like Summary, Problem Details, Impact, and Suggested Fix. Files missing the State section are rejected with a suggestion to author the plan first.

Does the workflow open a pull request or push implementation commits?▼

No. Only the initial InProgress state commit is pushed. The implementation is merged locally to master without opening a PR, and the completion commit and file move to docs/completed-tech-debt/ stay local.