Project Migrate FAQs

Question 1

What is the Project Migrate skill?

Accepted Answer

Project Migrate is an AI-powered capability for Claude Code designed to transition existing (brownfield) documentation into the SynthesisFlow directory structure. It uses intelligent content analysis to categorize files, generate metadata, and ensure your documentation follows best practices.

Question 2

When should I use this skill?

Accepted Answer

You should use this skill when moving an existing project to SynthesisFlow conventions, when your current documentation is unorganized (ad-hoc), or when you want to automatically add rich metadata and AI-generated frontmatter to legacy documents.

Question 3

What capabilities does the AI analysis provide?

Accepted Answer

Unlike simple script-based movers, this skill leverages the Gemini CLI to read and understand the actual content of your files. This allows it to accurately determine the document type (like specs, ADRs, or proposals) and generate high-quality, descriptive YAML frontmatter automatically.

Question 4

How does it protect my data during migration?

Accepted Answer

The skill prioritizes safety by creating a full timestamped backup and a rollback script before any changes occur. It also uses native 'git move' commands to ensure your file history remains intact throughout the restructuring process.

Question 5

Will my internal documentation links break?

Accepted Answer

No. One of the core features of Project Migrate is its automated link update phase, which recalculates and rewrites relative Markdown links within your files to match their new locations in the SynthesisFlow structure.

Project Migrate

Project Migrate

主な機能

ユースケース

主な機能

ユースケース