Use this skill to migrate existing projects to the AgenticDev structure. It uses an AI-powered analysis to intelligently discover, categorize, and migrate documentation, generate rich frontmatter, and preserve git history.
npx claudepluginhub joshuarweaver/cascade-code-devops-misc-1 --plugin bodangren-git-workflowThis skill uses the workspace's default tool permissions.
To intelligently migrate existing projects (brownfield) to the AgenticDev directory structure using a powerful, AI-assisted workflow. This skill goes beyond simple file moving by leveraging the **Gemini CLI** to analyze document content, ensuring accurate categorization and the generation of rich, meaningful metadata. It provides a safe, guided migration with discovery, analysis, backup, and va...
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
To intelligently migrate existing projects (brownfield) to the AgenticDev directory structure using a powerful, AI-assisted workflow. This skill goes beyond simple file moving by leveraging the Gemini CLI to analyze document content, ensuring accurate categorization and the generation of rich, meaningful metadata. It provides a safe, guided migration with discovery, analysis, backup, and validation phases to ensure zero data loss and high-quality results.
Use this skill in the following situations:
docs/, documentation/, wiki/, or markdown files).gemini CLI tool installed and authenticated.doc-indexer skill available for final compliance checking.The skill guides you through a series of phases with interactive approval.
Execute with one of three modes:
Interactive (default) - Review and approve each phase:
bash scripts/project-migrate.sh
Dry-run - Preview the plan without making any changes:
bash scripts/project-migrate.sh --dry-run
Auto-approve - Skip prompts for automation (useful for CI/CD):
bash scripts/project-migrate.sh --auto-approve
Phase 1 & 2 - AI-Powered Discovery and Analysis:
The script scans for all markdown files. For each file, it calls the Gemini CLI to analyze the document's content, not just its filename. This results in a much more accurate categorization of files into types like spec, proposal, adr, etc. The output is a detailed plan mapping each file to its new, correct location in the AgenticDev structure.
Phase 3 - Planning: Shows you the complete, AI-driven migration plan for your approval. You can review source and target mappings before any files are moved.
Phase 4 - Backup:
Creates a timestamped backup directory of your entire docs/ folder and includes a rollback.sh script before any changes are made.
Phase 5 - Migration:
Executes the plan, moving files using git mv to preserve history and creating the necessary directory structure.
Phase 6 - LLM-Based Link Updates: Uses the Gemini CLI to intelligently identify and correct broken or outdated relative links within migrated files. This LLM-based approach is more robust than simple path recalculation, as it understands document context and can handle edge cases that pattern matching might miss.
Phase 7 - Validation: Verifies that all files were migrated correctly, checks link integrity, and validates the new directory structure.
Phase 8 - AI-Powered Frontmatter Generation (Optional):
For files that lack YAML frontmatter, the script uses the Gemini CLI to read the file content and generate rich, doc-indexer compliant frontmatter. This includes a suggested title, the type determined during the analysis phase, and a concise description summarizing the document's purpose.
After successful completion:
doc-indexer skill to verify full documentation compliance.Symptom: The script fails during the "Analysis" or "Frontmatter Generation" phase with an error related to the gemini command.
Solution:
gemini CLI is installed and in your system's PATH.gemini auth.For issues related to permissions, conflicts, or broken links, the script provides detailed error messages and resolution suggestions during its interactive execution. The backup and rollback script is always available for a safe exit.
git mv.