gsd:from-gsd2

SkillAI & models

Import a GSD-2 (.gsd/) project back to GSD v1 (.planning/) format

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the gsd:from-gsd2 skill

What this skill tells your AI

The instructions your AI receives, as published by davepoon/buildwithclaude in plugins/gsd/skills/from-gsd2/SKILL.md and read by ahel’s review.

Maps the GSD-2 hierarchy (Milestone → Slice → Task) to the GSD v1 hierarchy (Milestone sections in ROADMAP.md → Phase → Plan), preserving completion state, research files, and summaries.

CJS-only: from-gsd2 is not on the gsd-sdk query registry; call gsd-tools.cjs as shown below (see docs/CLI-TOOLS.md).

  1. Locate the .gsd/ directory — check the current working directory (or --path argument):

    node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" from-gsd2 --dry-run
    

    If no .gsd/ is found, report the error and stop.

  2. Show the dry-run preview — present the full file list and migration statistics to the user. Ask for confirmation before writing anything.

  3. Run the migration after confirmation:

    node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" from-gsd2
    

    Use --force if .planning/ already exists and the user has confirmed overwrite.

  4. Report the result — show the filesWritten count, planningDir path, and the preview summary.

Signals

GitHub stars
4k
Forks
543
Last commit
Sep 2026
Advanced
Item type
skill
Key
gsd-from-gsd2
Source
github.com/davepoon/buildwithclaude