gsd-migrate

name	gsd-migrate
description	Migrates existing projects to GSD structure without rewriting history. Activates when user mentions "migrate to GSD", "adopt GSD", "convert project", "brownfield GSD", or wants to add GSD to existing work.
type	skill
category	gsd
status	stable
origin	tibsfox
modified	false
first_seen	"2026-02-07T00:00:00.000Z"
first_path	examples/gsd-migrate/SKILL.md
superseded_by	null

GSD Project Migration Assistant

Bridges the gap between existing projects and GSD adoption by inferring GSD artifacts from current project state, preserving git history and existing work.

When to Use

Activate when the user:

• Has an existing project and wants to adopt GSD
• Mentions "migrate", "convert to GSD", "add GSD"
• Asks "can I use GSD on an existing project?"
• Has brownfield code and wants structure

What This Skill Does

Analyzes existing project to extract:

• Project vision from README, package.json, docs
• Requirements from features, git commits, code analysis
• Current progress from file structure and git history
• Work remaining from TODOs, issues, backlog

Generates GSD artifacts that map current state:

• PROJECT.md (what this is, validated requirements, decisions)
• ROADMAP.md (completed phases + future work)
• STATE.md (current position)
• config.json (sensible defaults)

Preserves history:

• No git rewriting or rebasing
• Existing commits untouched
• GSD structure added on top

Migration Process

Phase 1: Discovery & Analysis

Step 1.1: Detect Project Type

# Analyze project indicators
if [ -f "package.json" ]; then
  PROJECT_TYPE="javascript"
  # Read: name, description, dependencies
elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
  PROJECT_TYPE="python"
elif [ -f "go.mod" ]; then
  PROJECT_TYPE="go"
elif [ -f "Cargo.toml" ]; then
  PROJECT_TYPE="rust"
fi

# Check for frameworks
if grep -q  package.json 2>/dev/null; 
  FRAMEWORK=
 grep -q  package.json 2>/dev/null; 
  FRAMEWORK=