project-migrate

What problem does it solve?

This Skill automates the complex and error-prone process of migrating existing project documentation into the structured AgenticDev format, ensuring consistency and preserving history.

Core Features & Use Cases

• AI-Powered Discovery: Intelligently analyzes existing markdown files to determine their correct type (spec, proposal, ADR, etc.).
• Safe Migration: Creates a full backup with a rollback script before making any changes, preserving git history with git mv.
• LLM-Enhanced Link Correction: Uses AI to fix broken relative links within migrated files.
• Use Case: You're adopting AgenticDev for a legacy project with years of scattered documentation. This skill will scan your docs/, documentation/, and root directories, categorize each file, move them to the appropriate docs/specs/, docs/changes/, or docs/ subdirectories, and update internal links, all while providing a safety net for rollback.

Quick Start

Run the project-migrate script interactively to begin migrating your existing documentation.