cyberneticlibrary

Migrate GSD-2 projects to GSD v1

gsd:from-gsd2skillsetup L13,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