skills.rest
mikefullerton
mikefullertonCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

repair-roadmap

Re-plan incomplete roadmap steps and write updated Roadmap.md under ~/.roadmaps.

Updated Aug 27, 2026
Search Tags:#workflow#planning#versioning#roadmap#repair#non-destructive#project-management
One-click install
npx skills add https://github.com/mikefullerton/cat-herding --skill repair-roadmap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repair-roadmap
Source: https://github.com/mikefullerton/cat-herding/tree/main/skills/repair-roadmap
Command: npx skills add https://github.com/mikefullerton/cat-herding --skill repair-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Repairing a broken or stuck roadmap by re-planning incomplete steps while preserving the original context and completed work.

Core Features & Use Cases

  • Re-plans an existing incomplete roadmap: reads the current roadmap, identifies gaps, and produces a revised roadmap using the same planning logic as /plan-roadmap.
  • Preserves the original for comparison by renaming it, and writes the updated Roadmap.md under ~/.roadmaps/<project>/.
  • Emphasizes non-implementation, guardrails, and audit-friendly history throughout the repair process.

Quick Start

Tell repair-roadmap which roadmap to repair and follow the prompts to generate a revised Roadmap.md.

Frequently Asked Questions about repair-roadmap

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

FAQPage Schema
How do I repair a broken or stalled project roadmap without losing completed work?▼

To repair a broken roadmap, this Skill re-plans incomplete or stuck steps while preserving completed work. It applies non-destructive revisions, renames the original roadmap for comparison, and writes the updated Roadmap.md under ~/.roadmaps.

What is the best way to re-plan an existing roadmap that has gaps or stuck steps?▼

Re-planning an existing roadmap involves identifying gaps in the incomplete steps and producing a revised version. This Skill uses the same planning logic as standard roadmap generation while keeping the original file intact for audit-friendly comparison.

Can I update an in-progress roadmap without overwriting the original project plan?▼

Yes, you can update an in-progress roadmap without overwriting the original. The process renames the initial roadmap file to preserve it for comparison, then writes the updated Roadmap.md safely under the ~/.roadmaps directory.

How does non-destructive roadmap revision work for project management workflows?▼

Non-destructive roadmap revision works by reading the current project plan, isolating incomplete items, and generating a revised roadmap. The original file is renamed rather than deleted, ensuring an audit-friendly history is maintained throughout the workflow.

What should I do when my project management roadmap is not working and needs a version update?▼

When your roadmap is not working, you can trigger a guided re-planning process. This applies guardrails and versioning to repair the stalled steps, outputting a fresh Roadmap.md while retaining the previous version for reference.

Are there limitations to repairing a roadmap after the project is already complete?▼

Yes, this repair process applies specifically to roadmaps that are in progress or stalled. It targets incomplete steps for re-planning, so fully completed roadmaps without pending tasks do not benefit from this revision workflow.

Related Skills

Explore More Product & Management Skills→
u9401066u9401066

roadmap-updater

Update ROADMAP.md statuses from commits during git workflows.

Community
Basic
whatwecandowhatwecando

forge-new-milestone

Plan the next milestone from ROADMAP.md and generate PLAN.md with tasks XML files.

Community
Advanced
tecnologia-ibtechtecnologia-ibtech

setup-project

Automate Codex project setup by generating AGENTS.md and scaffolding MCP servers.

Community
Advanced
Hoang604Hoang604

archive

Archive completed GTD task folders into a timestamped directory.

Community
Intermediate