project-migrate

To migrate existing project documentation to a new structure, this Skill uses AI-driven content analysis to discover, categorize, and move scattered markdown files into appropriate subdirectories while preserving git history. It requires Python scripts and Gemini CLI for advanced analysis.

Yes, you can automatically categorize markdown files when adopting a new project structure. The Skill intelligently analyzes existing markdown files to determine their correct type, such as specs, proposals, or ADRs, using AI-powered discovery.

The best way to fix broken relative links in migrated markdown files is using LLM-enhanced link correction. The Skill leverages AI to automatically identify and update internal links within migrated files during the structural transition.

Yes, you need Gemini CLI to automate documentation migration with this Skill. It requires the Gemini CLI dependency to perform advanced AI-driven content analysis and categorization for your brownfield projects.

To safely backup files before refactoring project documentation, the Skill creates a full backup with a rollback script before making any changes. It also preserves git history by using git mv for file operations.

Limitations of using AI for brownfield project migration include the requirement of specific dependencies like Gemini CLI and Python scripts. The process targets scattered markdown files and relies on automated categorization, meaning non-markdown formats are out of scope.