skills.rest
hadpadrahul
hadpadrahulCOMMUNITY
Explore all skills by this author →
GitHub

gsd-from-gsd2

Convert GSD-2 .gsd/ hierarchies into GSD v1 ROADMAP.md phases and PLAN entries.

Updated Apr 22, 2026
Search Tags:#planning#cli#migration#roadmap#gsd#gsd-2#gsd-v1
One-click install
npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-from-gsd2
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-from-gsd2
Source: https://github.com/hadpadrahul/school-erp/tree/main/.codex/skills/gsd-from-gsd2
Command: npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-from-gsd2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates a GSD-2 project back to GSD v1 planning format by converting the .gsd/ hierarchy (Milestone/Slice/Task) into ROADMAP.md milestones/phases and PLAN entries.

Core Features & Use Cases

  • Converts GSD-2 Milestones/Slices/Tasks into GSD v1 ROADMAP.md sections, phases, and plans.
  • Preserves completion status, research notes, and summaries during migration.
  • Supports dry-run previews and safe overwrites via the --force option.

Quick Start

Run the from-gsd2 tool on your project directory to generate a .planning/ directory from an existing .gsd/ workspace.

Frequently Asked Questions about gsd-from-gsd2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a GSD-2 project back to the GSD v1 planning format?▼

To migrate a GSD-2 project back to GSD v1, convert the .gsd/ hierarchy of Milestones, Slices, and Tasks into ROADMAP.md phases and PLAN entries using a CLI-based migration tool.

Can I preview the GSD-2 to v1 migration before overwriting my files?▼

Yes, you can preview the GSD-2 to v1 migration using a dry-run option. This allows you to verify the generated .planning/ directory structure before applying any non-destructive overwrites.

Does the GSD v1 migration preserve completion status and research notes?▼

Yes, migrating to the GSD v1 planning format preserves completion status, research notes, and summaries from your GSD-2 workspace during the conversion into ROADMAP.md sections.

What is the best way to convert .gsd/ workspace files into ROADMAP.md milestones?▼

The best way to convert .gsd/ workspace files into ROADMAP.md milestones is to run a CLI migration tool on your project directory, which transforms the GSD-2 hierarchy into v1 planning phases.

How does the --force option handle existing files during GSD v1 migration?▼

The --force option enables safe overwrites during GSD v1 migration, ensuring the conversion process can replace existing files in the target .planning/ directory without causing destructive data loss.

When do I need to reverse-migrate from GSD-2 to GSD v1 planning?▼

You need to reverse-migrate from GSD-2 to GSD v1 planning when reverting a project directory containing a .gsd/ workspace back to the legacy ROADMAP.md and PLAN entry format.

Related Skills

Explore More Software Engineering Skills→
aslaiiaslaii

gsd-from-gsd2

Migrate GSD-2 projects to GSD v1 format preserving hierarchy and completion state.

Community
Advanced
MINT-IAMINT-IA

gsd-manager

Manage milestone phases and dispatch background planning tasks from a terminal.

Official
Advanced
Poom5741Poom5741

gsd-from-gsd2

Converts GSD-2 projects to GSD v1 structure via gsd-tools.cjs.

Community
Advanced
abdullah1854abdullah1854
1

sub-agent-invocation

Route tasks to specialized sub-agents with context isolation for parallel work.

Community
Advanced