project-migrate

What problem does it solve?

This Skill automates the complex and time-consuming process of migrating existing project documentation into the structured AgenticDev format, ensuring accuracy and preserving history.

Core Features & Use Cases

• AI-Powered Discovery: Intelligently analyzes document content to categorize files accurately (specs, proposals, ADRs, etc.).
• Safe Migration: Creates full backups and provides rollback scripts to ensure zero data loss.
• Git History Preservation: Uses git mv to maintain file history.
• Automated Link Correction: Employs LLMs to fix broken or outdated relative links within migrated files.
• Rich Frontmatter Generation: Automatically generates metadata for discovered documents.
• Use Case: You have an existing project with scattered documentation. Use this Skill to automatically organize it into docs/specs/, docs/changes/, and docs/, while intelligently updating links and adding metadata.

Quick Start

Run the project-migrate script with bash scripts/project-migrate.sh to begin the migration process.