Migrate GSD-2 projects to GSD v1
gsd:from-gsd2skillsetup L1★3,035
davepoon/buildwithclaude ↗What it does
Migrate GSD-2 (.gsd/) project to GSD v1 (.planning/) format
Best for
Reverse-migrating legacy GSD-2 projects back to v1 format while preserving completion state and phase hierarchy.
Inputs
- · GSD-2 project directory with .gsd/ structure
- · Optional --path <dir> to specify migration source
- · Optional --force flag to overwrite existing .planning/
Outputs
- · GSD v1 .planning/ directory with ROADMAP.md, phases/, STATE.md, config.json
- · File list and migration statistics
- · Preserved completion state and phase order
Requires
- · gsd-tools.cjs (CJS-only, not on gsd-sdk registry)
- · node
Preconditions
- · .gsd/ directory exists (or --path provided)
- · gsd-tools.cjs available at ~/.claude/get-shit-done/bin/
- · .planning/ does not exist (or --force provided)
Failure modes
- · .gsd/ not found → error reported, migration stops
- · .planning/ exists without --force → stops before overwrite
- · Milestone/slice/task structure malformed → migration reports partial failures
- · GSD-2 cost ledger, database state, VS Code extension state → cannot be migrated (documented limitation)
Trust signals
- · Non-destructive: .gsd/ never modified
- · Dry-run preview before write
- · Completion state and numbering preserved
- · User confirmation gate before any file writes