Jeremy edf9d0be6f docs: add GitBook-ready user-facing documentation

33 markdown files organized for GitBook import with SUMMARY.md navigation.
Covers installation, core concepts, auto mode, configuration, all providers,
cost management, skills, parallel orchestration, remote questions, teams,
headless CI, and full command reference. User-facing only — no internal/dev content.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-11 10:34:07 -05:00

1.3 KiB

Raw Blame History

Migration from v1

If you have projects with .planning directories from the original Get Shit Done (v1), you can migrate them to GSD-2's .gsd format.

Running the Migration

# From within the project directory
/gsd migrate

# Or specify a path
/gsd migrate ~/projects/my-old-project

What Gets Migrated

The migration tool:

Parses your old PROJECT.md, ROADMAP.md, REQUIREMENTS.md, phase directories, plans, summaries, and research
Maps phases → slices, plans → tasks, milestones → milestones
Preserves completion state ([x] phases stay done, summaries carry over)
Consolidates research files into the new structure
Shows a preview before writing anything
Optionally runs an AI-driven review for quality assurance

Supported Formats

The migration handles various v1 format variations:

Milestone-sectioned roadmaps with <details> blocks
Bold phase entries
Bullet-format requirements
Decimal phase numbering
Duplicate phase numbers across milestones

Requirements

Migration works best with a ROADMAP.md file for milestone structure. Without one, milestones are inferred from the phases/ directory.

Post-Migration

After migrating, verify the output:

/gsd doctor

This checks .gsd/ integrity and flags any structural issues.

1.3 KiB Raw Blame History