What problem does it solve? Moving an existing project's documentation into a structured convention like SynthesisFlow is error-prone: files get miscategorized, relative links break, git history is lost, and there is no safe way to undo mistakes. This Skill automates the entire brownfield migration with backups, validation, and rollback support. ## Core Features & Use Cases - AI-Powered Discovery and Categorization: Uses the Gemini CLI to analyze document content and classify files as specs, proposals, ADRs, designs, plans, or general docs, then maps them to docs/specs/, docs/changes/, or docs/. - Safe Migration Workflow: Creates a timestamped backup with a rollback script, moves files with git mv to preserve history, and detects target conflicts before any changes are made. - LLM-Based Link Correction and Frontmatter Generation: Fixes broken relative links after moves and generates doc-indexer compliant YAML frontmatter for files that lack it. - Use Case: You inherit a repository with markdown scattered across docs/, wiki/, and the root. Run the script in dry-run mode to review the AI-generated migration plan, approve it, and get a fully reorganized SynthesisFlow structure with a rollback option. ## Quick Start Run the project-migrate script in dry-run mode to preview how my existing markdown documentation would be reorganized into the SynthesisFlow structure.
