How does the skill handle existing dependencies?

It extracts dependency information from your old matrix or feature files and inlines them as '**Depends on**' fields directly within the new DELTAS.md entries.

Can I preview the new structure before it is created?

Yes, the skill performs a domain analysis and presents the proposed nested directory structure for feature specs and designs for your approval before execution.

What is the main benefit of migrating to a delta-based workflow?

It shifts the focus from monolithic features to granular, incremental changes called 'deltas,' making tracking, implementation, and code reviews much more manageable in complex projects.

Will I lose my existing project documentation during migration?

No, the skill renames and moves your existing files while preserving their content, and it provides an option to archive the original structure for safety.

What happens to the BACKLOG.md file?

You are given the option to delete it, archive it to a backup folder, or selectively convert backlog items into new deltas during the migration.

Katachi Project Migrator

Name: Katachi Project Migrator
Author: asermax

byasermax

•

Productivity & Workflow

Automates the transition of Katachi projects from feature-centric to delta-based development workflows.

This skill streamlines the modernization of Katachi-based projects by migrating legacy feature tracking to a more granular, delta-centric workflow. It handles the complete restructuring of project documentation, including converting FEATURES.md to DELTAS.md, remapping IDs, and moving specification and design files into specialized delta directories. By intelligently grouping deltas into capability domains and inlining dependencies, it provides a cleaner, more scalable structure for incremental development while maintaining full data integrity and providing a clear path for future implementation.

Key Features

01Structural migration of specs and designs into delta-based directory systems

02Intelligent domain analysis for grouping deltas into logical capability hierarchies

03Inlines external dependencies directly into delta entries for improved visibility

04Automated FEATURES.md to DELTAS.md conversion with sequential DLT-ID mapping

051 GitHub stars

06Parallel task execution for rapid, multi-stage project restructuring

Use Cases

01Consolidating fragmented dependency matrices into a centralized project plan

02Reorganizing flat feature lists into hierarchical, domain-driven capability documentation

03Modernizing a legacy Katachi project to support incremental delta-based development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins migrate-to-deltas

For use in Claude.ai and ChatGPT

Download Skill