skills.rest
workinprogress-ai
workinprogress-aiOFFICIAL
Explore all skills by this author →
GitHub

devenv-refine-roadmap

Refines Markdown roadmap documents by splitting, merging, and re-sequencing steps while preserving IDs and issue links.

Updated Jul 4, 2024
Search Tags:#workflow#project management#documentation#refinement#github#roadmap
One-click install
npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refine-roadmap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: devenv-refine-roadmap
Source: https://github.com/workinprogress-ai/devenv/tree/main/copilot/skills/devenv-refine-roadmap
Command: npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refine-roadmap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves the challenge of maintaining roadmap integrity when project blueprints change, requirements evolve, or implementation discovery necessitates structural adjustments like splitting steps or re-sequencing phases.

Core Features & Use Cases

  • Structural Integrity: Updates roadmap structure while preserving historical step IDs, issue links, and dependency edges.
  • Change Management: Automatically logs deletions and modifications in a dedicated Revision History section.
  • Use Case: When a large implementation task is discovered to be too complex, use this skill to split the step into smaller, manageable units while maintaining the original issue tracking and dependency chain.

Quick Start

Invoke the devenv-refine-roadmap skill by providing the file path to the specific roadmap document you need to update.

Frequently Asked Questions about devenv-refine-roadmap

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

FAQPage Schema
How do I update a project roadmap when implementation steps need to be split or re-sequenced?▼

To refine a project roadmap, you can structurally update Markdown roadmap files by splitting steps, merging phases, and re-sequencing while preserving historical step IDs and dependency edges. Modifications are automatically logged in a revision history section.

How does roadmap refinement maintain consistency with GitHub issue tracking?▼

Roadmap refinement maintains GitHub issue tracking consistency by preserving existing issue links during structural modifications. It parses roadmap syntax to ensure historical continuity of step IDs and dependency chains across project documentation.

Can I log structural modifications made to a Markdown roadmap document automatically?▼

Yes, you can log structural modifications automatically. When you refine a roadmap, deletions and modifications are documented in a dedicated Revision History section within the Markdown file to ensure traceability of structural changes.

What is the best way to handle complex roadmap steps discovered during project implementation?▼

The best way to handle complex roadmap steps is to split them into smaller, manageable units. This refinement process maintains the original issue tracking links and dependency chain while updating the overall project roadmap structure.

Do I need a specific file format to re-sequence phases in a project roadmap?▼

Yes, you need Markdown-based roadmap files. The refinement process operates specifically on Markdown documents by parsing their roadmap syntax to re-sequence phases, split steps, and integrate blueprint changes effectively.

When should I use structural roadmap refinement instead of manually editing project documentation?▼

You should use structural roadmap refinement when blueprint changes occur or requirements evolve, necessitating structural adjustments. It ensures historical continuity of step IDs and dependency edges that manual editing risks breaking.

Related Skills

Explore More Software Engineering Skills→
workinprogress-aiworkinprogress-ai

devenv-update-roadmap

Synchronize roadmap Markdown files with GitHub issue and pull request states.

Official
Advanced
ereferenereferen

sync

Synchronizes GitHub issue/PR states with CLAUDE.md TODO items.

Community
Intermediate
patcarter883patcarter883

gsdd-complete-milestone

Automates milestone closure by archiving phase data and updating specifications and roadmap from parsed files.

Community
Advanced
NUbivekNUbivek

gsd-insert-phase

Insert urgent tasks into project roadmaps with decimal phase numbers.

Community
Intermediate