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.1 KiB

Raw Blame History

GitHub Sync

GSD can auto-sync milestones, slices, and tasks to GitHub Issues, PRs, and Milestones.

Setup

Install and authenticate the gh CLI:
```
gh auth login
```

Enable in preferences:

github:
  enabled: true
  repo: "owner/repo"              # auto-detected from git remote if omitted
  labels: [gsd, auto-generated]   # labels for created items

Commands

Command	Description
`/github-sync bootstrap`	Initial setup — creates GitHub Milestones, Issues, and draft PRs from current `.gsd/` state
`/github-sync status`	Show sync mapping counts (milestones, slices, tasks)

How It Works

Milestones → GitHub Milestones
Slices → GitHub Issues (linked to milestone)
Tasks → GitHub Issue checklists
Completed slices → Draft PRs

Sync mapping is persisted in .gsd/.github-sync.json. The sync is rate-limit aware — it skips when the GitHub API rate limit is low.

Configuration

github:
  enabled: true
  repo: "owner/repo"
  labels: [gsd, auto-generated]
  project: "Project ID"           # optional: GitHub Project board

1.1 KiB Raw Blame History