What happens if a migration fails?

The skill includes verification steps that run after every migration. If a check fails, it alerts the user and displays the file for manual review.

What does the Kata Project Doctor actually fix?

It primarily handles two tasks: migrating ROADMAP.md files to the latest standard format and resolving duplicate numeric prefixes in phase directories by re-sequencing them globally.

Does this skill work with Git repositories?

Yes, if enabled in your config, the skill will automatically stage and commit structural changes to your project documents and directory tree.

Can I run this health check automatically?

Yes, by passing the --auto argument, the skill can perform roadmap migrations without manual intervention, though it will still prompt for directory renames to ensure safety.

Kata Project Doctor

Name: Kata Project Doctor
Author: gannonh

bygannonh

•

Productivity & Workflow

Diagnoses and repairs structural issues in Kata projects, including roadmap formatting and phase directory collisions.

Kata Project Doctor is a specialized maintenance utility for the Kata development framework, designed to ensure project structure remains consistent and healthy. It automatically detects outdated ROADMAP.md formats and migrates them to current specifications, while identifying and resolving directory naming collisions through globally sequential numbering. Whether running interactively with confirmation prompts or in a streamlined auto-mode, it simplifies complex project refactoring and documentation updates, ensuring your planning files and directory structures stay perfectly synchronized.

Key Features

01Support for interactive and non-interactive (--auto) modes

02Automated ROADMAP.md format detection and migration

03Integrated Git committing for structural and documentation fixes

04Phase directory collision detection across all project states

05Globally sequential re-numbering for project phases

061 GitHub stars

Use Cases

01Resolving directory prefix conflicts after merging multiple development branches

02Upgrading legacy Kata projects to the latest architectural standards

03Standardizing project roadmaps for consistent progress tracking and visibility

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gannonh/kata-skills kata-doctor

For use in Claude.ai and ChatGPT

Download Skill