Can I move a phase that is already in progress?

No, to ensure data integrity, the skill only permits moving or reordering pending phases that do not have executed plans or SUMMARY.md files.

Will this update my project progress tracking?

Yes, it automatically updates STATE.md, adds a roadmap evolution note, and recalculates progress percentages based on the new milestone configuration.

What happens to the physical directories on my disk?

The skill performs a multi-pass renaming process to prevent collisions, updating directory names and internal file references (like PLAN.md) to match the new roadmap sequence.

Does it handle sub-phases or decimal numbers?

Yes, it automatically detects and renumbers decimal phases (e.g., Phase 1.1, 1.2) along with their parent integer phase during any move or reorder operation.

Does it support version control?

By default, the skill stages all changes to the .planning directory and creates a descriptive git commit to maintain a historical record of the reorganization.

Kata Phase Organizer

Name: Kata Phase Organizer
Author: gannonh

bygannonh

•

生产力与工作流

Reorganize project phases across milestones and reorder roadmap tasks with automated directory and documentation updates.

Kata Phase Organizer is a specialized Claude Code skill designed for flexible project planning and roadmap management. It allows developers to seamlessly move pending phases between different milestones or change their sequence within a single milestone, automatically handling the complex task of renumbering directories, updating ROADMAP.md and STATE.md files, and maintaining git history. By validating phase states and preventing the movement of active or completed work, it ensures structural integrity and consistency across your project's planning documentation and physical file structure.

主要功能

01Synchronized ROADMAP.md and STATE.md documentation maintenance

02Cross-milestone phase migration with automatic target renumbering

03Intelligent within-milestone reordering using 'before' and 'after' logic

04Safe execution with pre-flight roadmap validation and user confirmation

05Automated directory renaming and internal file reference updates

061 GitHub stars

使用场景

01Restructuring a project roadmap after a change in technical requirements or scope

02Adjusting the implementation order of pending tasks within a specific sprint

03Shifting a low-priority feature from the current milestone to a future release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gannonh/kata-marketplace kata-move-phase

For use in Claude.ai and ChatGPT

主要功能

01Synchronized ROADMAP.md and STATE.md documentation maintenance

02Cross-milestone phase migration with automatic target renumbering

03Intelligent within-milestone reordering using 'before' and 'after' logic

04Safe execution with pre-flight roadmap validation and user confirmation

05Automated directory renaming and internal file reference updates

061 GitHub stars

使用场景

01Restructuring a project roadmap after a change in technical requirements or scope

02Adjusting the implementation order of pending tasks within a specific sprint

03Shifting a low-priority feature from the current milestone to a future release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gannonh/kata-marketplace kata-move-phase

For use in Claude.ai and ChatGPT