skills.rest
aslaii
aslaiiCOMMUNITY
Explore all skills by this author →
GitHub

gsd-from-gsd2

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

Updated Jan 28, 2025
Search Tags:#automation#planning#migration#roadmap#gsd#gsd2
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-from-gsd2-aslaii
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-from-gsd2
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-from-gsd2
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-from-gsd2-aslaii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a GSD-2 project (.gsd/) into GSD v1 format (.planning/), preserving structure and completion state to maintain historical context.

Core Features & Use Cases

  • Maps Milestone → Slice → Task from GSD-2 into ROADMAP.md milestones, phases, and plans in GSD v1 while preserving done statuses and associated research files.
  • Non-destructive migration with a dry-run option and a --path flag to target different directories; supports safe overwriting with --force.
  • Works with the from-gsd2 workflow via gsd-tools.cjs to perform the actual migration and provides a preview with file mappings before applying changes.

Quick Start

Run the migration on a local .gsd/ project to generate the corresponding .planning/ directory.

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 GSD v1 format?▼

To migrate a GSD-2 project to GSD v1 format, use the from-gsd2 workflow via the gsd-tools.cjs CLI. It converts your local .gsd/ directory into a .planning/ directory while preserving the original task hierarchy and completion state.

Does GSD-2 to GSD v1 migration overwrite existing planning files?▼

Migration is non-destructive and provides a dry-run option to preview file mappings before applying changes. You must explicitly use the --force flag to overwrite an existing .planning/ directory once changes are confirmed.

Can I preview GSD-2 to GSD v1 migration changes before applying them?▼

Yes, you can preview migration changes by running the gsd-tools.cjs CLI with the --dry-run flag first. This displays the file mappings and structure conversions before any actual modifications are made to your project.

How does GSD v1 format map the structure from a GSD-2 project?▼

The migration maps Milestone, Slice, and Task structures from GSD-2 into ROADMAP.md milestones, phases, and plans in GSD v1 format. It preserves done statuses and associated research files to maintain historical context.

Can I target a specific local directory for GSD-2 to GSD v1 migration?▼

Yes, you can target different local directories for migration using the --path option. This allows you to specify the exact location of your GSD-2 project rather than defaulting to the current working directory.

Related Skills

Explore More Software Engineering Skills→
Poom5741Poom5741

gsd-from-gsd2

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

Community
Advanced
Poom5741Poom5741

gsd-cleanup

Archive completed milestone phase directories into versioned .planning/milestones folders.

Community
Intermediate
dobrinz123dobrinz123

gsd-set-profile

Set GSD agent model profiles to quality, balanced, budget, or inherit.

Community
Basic
batFormatbatFormat

aif-implement

Execute development tasks sequentially from a plan file with progress tracking.

Community
Advanced