# GSD 명령어 레퍼런스

> 전체 명령어 문법, 플래그, 옵션, 사용 예시를 다룹니다. 기능 상세 설명은 [Feature Reference](FEATURES.md)를 참고하세요. 워크플로우 안내는 [User Guide](USER-GUIDE.md)를 참고하세요.

---

## 명령어 문법

- **Claude Code / Gemini / Copilot:** `/gsd-command-name [args]`
- **OpenCode / Kilo:** `/gsd-command-name [args]`
- **Codex:** `$gsd-command-name [args]`

---

## 핵심 워크플로우 명령어

### `/gsd-new-project`

심층 컨텍스트 수집을 통해 새 프로젝트를 초기화합니다.

| 플래그 | 설명 |
|--------|------|
| `--auto @file.md` | 문서에서 자동으로 정보를 추출하고 대화형 질문을 건너뜁니다 |

**사전 조건:** `.planning/PROJECT.md`가 존재하지 않아야 합니다.
**생성 파일:** `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, `config.json`, `research/`, `CLAUDE.md`

```bash
/gsd-new-project                    # 대화형 모드
/gsd-new-project --auto @prd.md     # PRD에서 자동 추출
```

---

### `/gsd-new-workspace`

격리된 워크스페이스를 생성합니다. 저장소 복사본과 독립적인 `.planning/` 디렉터리가 포함됩니다.

| 플래그 | 설명 |
|--------|------|
| `--name <name>` | 워크스페이스 이름 (필수) |
| `--repos repo1,repo2` | 쉼표로 구분된 저장소 경로 또는 이름 |
| `--path /target` | 대상 디렉터리 (기본값: `~/gsd-workspaces/<name>`) |
| `--strategy worktree\|clone` | 복사 전략 (기본값: `worktree`) |
| `--branch <name>` | 체크아웃할 브랜치 (기본값: `workspace/<name>`) |
| `--auto` | 대화형 질문을 건너뜁니다 |

**사용 사례.**
- 멀티 저장소: 격리된 GSD 상태로 일부 저장소만 작업합니다.
- 기능 격리: `--repos .`는 현재 저장소의 worktree를 생성합니다.

**생성 파일:** `WORKSPACE.md`, `.planning/`, 저장소 복사본 (worktree 또는 clone)

```bash
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
/gsd-new-workspace --name feature-b --repos . --strategy worktree  # 동일 저장소 격리
/gsd-new-workspace --name spike --repos api,web --strategy clone   # 전체 클론
```

---

### `/gsd-list-workspaces`

활성 GSD 워크스페이스와 상태를 목록으로 표시합니다.

**스캔 위치:** `~/gsd-workspaces/`에서 `WORKSPACE.md` 매니페스트를 탐색합니다.
**표시 항목:** 이름, 저장소 수, 전략, GSD 프로젝트 상태

```bash
/gsd-list-workspaces
```

---

### `/gsd-remove-workspace`

워크스페이스를 제거하고 git worktree를 정리합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `<name>` | 예 | 제거할 워크스페이스 이름 |

**안전 장치:** 저장소에 커밋되지 않은 변경사항이 있으면 제거를 거부합니다. 이름 확인이 필요합니다.

```bash
/gsd-remove-workspace feature-b
```

---

### `/gsd-discuss-phase`

계획 수립 전에 구현 결정사항을 캡처합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 (기본값: 현재 페이즈) |

| 플래그 | 설명 |
|--------|------|
| `--auto` | 모든 질문에 추천 기본값을 자동으로 선택합니다 |
| `--batch` | 질문을 하나씩 처리하는 대신 일괄 입력 방식으로 그룹화합니다 |
| `--analyze` | 토론 중 트레이드오프 분석을 추가합니다 |
| `--chain` | discuss → plan → execute를 하나의 플로우로 자동 체인합니다 (v1.31) |
| `--power` | 준비된 답변 파일에서 일괄 입력으로 질문에 답변합니다 (v1.32) |

**사전 조건:** `.planning/ROADMAP.md`가 존재해야 합니다.
**생성 파일:** `{phase}-CONTEXT.md`, `{phase}-DISCUSSION-LOG.md` (감사 추적)

```bash
/gsd-discuss-phase 1                # 페이즈 1 대화형 토론
/gsd-discuss-phase 3 --auto         # 페이즈 3 기본값 자동 선택
/gsd-discuss-phase --batch          # 현재 페이즈 일괄 모드
/gsd-discuss-phase 2 --analyze      # 트레이드오프 분석 포함 토론
```

---

### `/gsd-ui-phase`

프론트엔드 페이즈를 위한 UI 설계 계약을 생성합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 (기본값: 현재 페이즈) |

**사전 조건:** `.planning/ROADMAP.md`가 존재해야 하며 해당 페이즈에 프론트엔드/UI 작업이 포함되어야 합니다.
**생성 파일:** `{phase}-UI-SPEC.md`

```bash
/gsd-ui-phase 2                     # 페이즈 2 설계 계약 생성
```

---

### `/gsd-plan-phase`

페이즈를 조사하고 계획하며 검증합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 (기본값: 다음 미계획 페이즈) |

| 플래그 | 설명 |
|--------|------|
| `--auto` | 대화형 확인을 건너뜁니다 |
| `--research` | RESEARCH.md가 있어도 재조사를 강제합니다 |
| `--skip-research` | 도메인 조사 단계를 건너뜁니다 |
| `--gaps` | 갭 보완 모드 (VERIFICATION.md를 읽고 조사를 건너뜁니다) |
| `--skip-verify` | 계획 검증 루프를 건너뜁니다 |
| `--prd <file>` | discuss-phase 대신 PRD 파일을 컨텍스트로 사용합니다 |
| `--reviews` | REVIEWS.md의 교차 AI 리뷰 피드백으로 재계획합니다 |

**사전 조건:** `.planning/ROADMAP.md`가 존재해야 합니다.
**생성 파일:** `{phase}-RESEARCH.md`, `{phase}-{N}-PLAN.md`, `{phase}-VALIDATION.md`

```bash
/gsd-plan-phase 1                   # 페이즈 1 조사 + 계획 + 검증
/gsd-plan-phase 3 --skip-research   # 조사 없이 계획 (익숙한 도메인)
/gsd-plan-phase --auto              # 비대화형 계획 수립
```

---

### `/gsd-execute-phase`

페이즈의 모든 계획을 웨이브 기반 병렬화로 실행하거나 특정 웨이브만 실행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | **예** | 실행할 페이즈 번호 |
| `--wave N` | 아니오 | 페이즈 내 Wave `N`만 실행합니다 |

**사전 조건:** 페이즈에 PLAN.md 파일이 있어야 합니다.
**생성 파일:** 계획별 `{phase}-{N}-SUMMARY.md`, git 커밋, 페이즈가 완전히 완료되면 `{phase}-VERIFICATION.md`

```bash
/gsd-execute-phase 1                # 페이즈 1 실행
/gsd-execute-phase 1 --wave 2       # Wave 2만 실행
```

---

### `/gsd-verify-work`

자동 진단을 포함한 사용자 인수 테스트(UAT)를 수행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 (기본값: 마지막 실행된 페이즈) |

**사전 조건:** 페이즈가 실행되어 있어야 합니다.
**생성 파일:** `{phase}-UAT.md`, 문제 발견 시 수정 계획

```bash
/gsd-verify-work 1                  # 페이즈 1 UAT
```

---

### `/gsd-next`

다음 논리적 워크플로우 단계로 자동으로 이동합니다. 프로젝트 상태를 읽고 적절한 명령어를 실행합니다.

**사전 조건:** `.planning/` 디렉터리가 존재해야 합니다.
**동작 방식.**
- 프로젝트 없음 → `/gsd-new-project` 제안
- 페이즈 토론 필요 → `/gsd-discuss-phase` 실행
- 페이즈 계획 필요 → `/gsd-plan-phase` 실행
- 페이즈 실행 필요 → `/gsd-execute-phase` 실행
- 페이즈 검증 필요 → `/gsd-verify-work` 실행
- 모든 페이즈 완료 → `/gsd-complete-milestone` 제안

```bash
/gsd-next                           # 다음 단계 자동 감지 및 실행
```

---

### `/gsd-session-report`

작업 요약, 결과, 예상 리소스 사용량을 포함한 세션 보고서를 생성합니다.

**사전 조건:** 최근 작업이 있는 활성 프로젝트
**생성 파일:** `.planning/reports/SESSION_REPORT.md`

```bash
/gsd-session-report                 # 세션 종료 후 요약 생성
```

**보고서 포함 내용.**
- 수행된 작업 (커밋, 실행된 계획, 진행된 페이즈)
- 결과 및 산출물
- 블로커 및 결정 사항
- 예상 토큰/비용 사용량
- 다음 단계 권장사항

---

### `/gsd-ship`

완료된 페이즈 작업으로부터 자동 생성된 본문이 포함된 PR을 만듭니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 또는 마일스톤 버전 (예: `4` 또는 `v1.0`) |
| `--draft` | 아니오 | 초안 PR로 생성합니다 |

**사전 조건:** 페이즈 검증 완료 (`/gsd-verify-work` 통과), `gh` CLI 설치 및 인증
**생성 파일:** 계획 아티팩트 기반의 풍부한 본문이 포함된 GitHub PR, STATE.md 업데이트

```bash
/gsd-ship 4                         # 페이즈 4 출시
/gsd-ship 4 --draft                 # 초안 PR로 출시
```

**PR 본문 포함 내용.**
- ROADMAP.md의 페이즈 목표
- SUMMARY.md 파일의 변경사항 요약
- 처리된 요구사항 (REQ-ID)
- 검증 상태
- 핵심 결정사항

---

### `/gsd-ui-review`

구현된 프론트엔드의 6개 기둥 기반 시각적 감사를 소급하여 수행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 (기본값: 마지막 실행된 페이즈) |

**사전 조건:** 프론트엔드 코드가 있는 프로젝트 (독립 실행 가능, GSD 프로젝트 불필요)
**생성 파일:** `{phase}-UI-REVIEW.md`, `.planning/ui-reviews/`에 스크린샷

```bash
/gsd-ui-review                      # 현재 페이즈 감사
/gsd-ui-review 3                    # 페이즈 3 감사
```

---

### `/gsd-audit-uat`

모든 미완료 UAT 및 검증 항목에 대한 교차 페이즈 감사를 수행합니다.

**사전 조건:** UAT 또는 검증이 포함된 페이즈가 하나 이상 실행되어 있어야 합니다.
**생성 파일:** 사람이 직접 수행하는 테스트 계획이 포함된 분류된 감사 보고서

```bash
/gsd-audit-uat
```

---

### `/gsd-audit-milestone`

마일스톤이 완료 정의를 충족했는지 검증합니다.

**사전 조건:** 모든 페이즈가 실행되어 있어야 합니다.
**생성 파일:** 갭 분석이 포함된 감사 보고서

```bash
/gsd-audit-milestone
```

---

### `/gsd-complete-milestone`

마일스톤을 아카이브하고 릴리스 태그를 생성합니다.

**사전 조건:** 마일스톤 감사 완료 권장
**생성 파일:** `MILESTONES.md` 항목, git 태그

```bash
/gsd-complete-milestone
```

---

### `/gsd-milestone-summary`

팀 온보딩 및 리뷰를 위해 마일스톤 아티팩트로부터 포괄적인 프로젝트 요약을 생성합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `version` | 아니오 | 마일스톤 버전 (기본값: 현재/최신 마일스톤) |

**사전 조건:** 완료되었거나 진행 중인 마일스톤이 하나 이상 있어야 합니다.
**생성 파일:** `.planning/reports/MILESTONE_SUMMARY-v{version}.md`

**요약 포함 내용.**
- 개요, 아키텍처 결정사항, 페이즈별 분석
- 핵심 결정사항 및 트레이드오프
- 요구사항 충족 현황
- 기술 부채 및 지연 항목
- 신규 팀원을 위한 시작 가이드
- 생성 후 대화형 Q&A 제공

```bash
/gsd-milestone-summary                # 현재 마일스톤 요약
/gsd-milestone-summary v1.0           # 특정 마일스톤 요약
```

---

### `/gsd-new-milestone`

다음 버전 사이클을 시작합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `name` | 아니오 | 마일스톤 이름 |
| `--reset-phase-numbers` | 아니오 | 새 마일스톤을 Phase 1부터 시작하고 로드맵 작업 전에 기존 페이즈 디렉터리를 아카이브합니다 |

**사전 조건:** 이전 마일스톤이 완료되어 있어야 합니다.
**생성 파일:** 업데이트된 `PROJECT.md`, 새 `REQUIREMENTS.md`, 새 `ROADMAP.md`

```bash
/gsd-new-milestone                  # 대화형 모드
/gsd-new-milestone "v2.0 Mobile"    # 이름이 지정된 마일스톤
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile"  # 마일스톤 번호를 1부터 재시작
```

---

## 페이즈 관리 명령어

### `/gsd-add-phase`

로드맵에 새 페이즈를 추가합니다.

```bash
/gsd-add-phase                      # 대화형 — 페이즈를 설명합니다
```

### `/gsd-insert-phase`

소수점 번호 체계를 사용하여 페이즈 사이에 긴급 작업을 삽입합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 이 페이즈 번호 다음에 삽입합니다 |

```bash
/gsd-insert-phase 3                 # 페이즈 3과 4 사이에 삽입 → 3.1 생성
```

### `/gsd-remove-phase`

미래 페이즈를 제거하고 이후 페이즈 번호를 재정렬합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 제거할 페이즈 번호 |

```bash
/gsd-remove-phase 7                 # 페이즈 7 제거, 8→7, 9→8 등으로 재번호
```

### `/gsd-list-phase-assumptions`

계획 수립 전 Claude의 예상 접근 방식을 미리 확인합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 |

```bash
/gsd-list-phase-assumptions 2       # 페이즈 2 가정 사항 확인
```

### `/gsd-plan-milestone-gaps`

마일스톤 감사에서 발견된 갭을 보완하는 페이즈를 생성합니다.

```bash
/gsd-plan-milestone-gaps             # 각 감사 갭에 대한 페이즈 생성
```

### `/gsd-research-phase`

심층 에코시스템 조사만 수행합니다 (독립 실행 — 일반적으로 `/gsd-plan-phase`를 사용하세요).

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 |

```bash
/gsd-research-phase 4               # 페이즈 4 도메인 조사
```

### `/gsd-validate-phase`

Nyquist 검증 갭을 소급하여 감사하고 보완합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 |

```bash
/gsd-validate-phase 2               # 페이즈 2 테스트 커버리지 감사
```

---

## 탐색 명령어

### `/gsd-progress`

상태와 다음 단계를 표시합니다.

```bash
/gsd-progress                       # "지금 어디 있나? 다음은 무엇인가?"
```

### `/gsd-resume-work`

마지막 세션의 전체 컨텍스트를 복원합니다.

```bash
/gsd-resume-work                    # 컨텍스트 초기화 또는 새 세션 후 실행
```

### `/gsd-pause-work`

페이즈 중간에 중단할 때 컨텍스트 핸드오프를 저장합니다.

```bash
/gsd-pause-work                     # continue-here.md 생성
```

### `/gsd-manager`

하나의 터미널에서 여러 페이즈를 관리하는 대화형 명령 센터입니다.

**사전 조건:** `.planning/ROADMAP.md`가 존재해야 합니다.
**동작 방식.**
- 시각적 상태 표시기가 포함된 모든 페이즈 대시보드
- 의존성과 진행 상황에 따른 최적 다음 작업 추천
- 작업 디스패치: discuss는 인라인으로 실행되고 plan/execute는 백그라운드 에이전트로 실행됩니다
- 하나의 터미널에서 여러 페이즈를 병렬로 처리하는 파워 유저를 위해 설계되었습니다

```bash
/gsd-manager                        # 명령 센터 대시보드 열기
```

---

### `/gsd-analyze-dependencies`

페이즈 의존성을 감지하고 ROADMAP.md에 `Depends on` 항목을 제안합니다. (v1.32)

**사전 조건:** `.planning/ROADMAP.md`가 존재해야 합니다.
**감지 방법:** 파일 겹침, 의미적 의존성(API/스키마 생산자-소비자), 데이터 흐름 의존성
**동작 방식:** 의존성 제안 테이블을 표시하고 사용자 확인 후 ROADMAP.md의 `Depends on` 필드를 업데이트합니다.

```bash
/gsd-analyze-dependencies            # 의존성 분석 및 제안
```

---

### `/gsd-help`

모든 명령어와 사용 가이드를 표시합니다.

```bash
/gsd-help                           # 빠른 레퍼런스
```

---

## 유틸리티 명령어

### `/gsd-quick`

GSD 보증을 갖춘 임시 작업을 실행합니다.

| 플래그 | 설명 |
|--------|------|
| `--full` | 계획 검사 (2회 반복) + 실행 후 검증 활성화 |
| `--discuss` | 경량 사전 계획 토론 |
| `--research` | 계획 전 집중 조사자 스폰 |

플래그는 조합하여 사용할 수 있습니다.

```bash
/gsd-quick                          # 기본 빠른 작업
/gsd-quick --discuss --research     # 토론 + 조사 + 계획
/gsd-quick --full                   # 계획 검사 및 검증 포함
/gsd-quick --discuss --research --full  # 모든 선택적 단계 포함
```

### `/gsd-autonomous`

남은 모든 페이즈를 자율적으로 실행합니다.

| 플래그 | 설명 |
|--------|------|
| `--from N` | 특정 페이즈 번호부터 시작합니다 |
| `--to N` | 페이즈 N 완료 후 자율 실행을 중단합니다 (v1.32) |
| `--only N` | 지정된 단일 페이즈만 자율적으로 실행합니다 (v1.31) |
| `--interactive` | 각 페이즈의 discuss 단계에서 사용자 확인을 요청합니다 |

```bash
/gsd-autonomous                     # 남은 모든 페이즈 실행
/gsd-autonomous --from 3            # 페이즈 3부터 시작
/gsd-autonomous --to 5              # 페이즈 5까지만 실행
/gsd-autonomous --from 3 --to 5     # 페이즈 3~5 범위 실행
/gsd-autonomous --only 4            # 페이즈 4만 자율 실행
```

### `/gsd-do`

자유 형식 텍스트를 적절한 GSD 명령어로 라우팅합니다.

```bash
/gsd-do                             # 원하는 작업을 설명합니다
```

### `/gsd-note`

마찰 없는 아이디어 캡처 — 노트 추가, 목록 조회, 또는 노트를 할 일로 승격합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `text` | 아니오 | 캡처할 노트 텍스트 (기본값: 추가 모드) |
| `list` | 아니오 | 프로젝트 및 전역 범위의 모든 노트 목록 |
| `promote N` | 아니오 | N번 노트를 구조화된 할 일로 변환 |

| 플래그 | 설명 |
|--------|------|
| `--global` | 노트 작업에 전역 범위 사용 |

```bash
/gsd-note "Consider caching strategy for API responses"
/gsd-note list
/gsd-note promote 3
```

### `/gsd-debug`

지속적인 상태를 유지하는 체계적인 디버깅을 수행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `description` | 아니오 | 버그 설명 |

| 플래그 | 설명 |
|--------|------|
| `--diagnose` | 수정 없이 조사만 수행하는 진단 전용 모드 (v1.32) |

```bash
/gsd-debug "Login button not responding on mobile Safari"
/gsd-debug --diagnose "API returning 500 on /users endpoint"
```

### `/gsd-add-todo`

나중을 위한 아이디어나 작업을 캡처합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `description` | 아니오 | 할 일 설명 |

```bash
/gsd-add-todo "Consider adding dark mode support"
```

### `/gsd-check-todos`

보류 중인 할 일 목록을 표시하고 작업할 항목을 선택합니다.

```bash
/gsd-check-todos
```

### `/gsd-add-tests`

완료된 페이즈에 대한 테스트를 생성합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 |

```bash
/gsd-add-tests 2                    # 페이즈 2 테스트 생성
```

### `/gsd-stats`

프로젝트 통계를 표시합니다.

```bash
/gsd-stats                          # 프로젝트 지표 대시보드
```

### `/gsd-profile-user`

Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일, 의사결정 패턴, 디버깅 접근 방식, UX 선호도, 벤더 선택, 불만 유발 요인, 학습 스타일, 설명 깊이)으로 개발자 행동 프로필을 생성합니다. Claude의 응답을 개인화하는 아티팩트를 생성합니다.

| 플래그 | 설명 |
|--------|------|
| `--questionnaire` | 세션 분석 대신 대화형 설문지를 사용합니다 |
| `--refresh` | 세션을 재분석하고 프로필을 재생성합니다 |

**생성 아티팩트.**
- `USER-PROFILE.md` — 전체 행동 프로필
- `/gsd-dev-preferences` 명령어 — 모든 세션에서 선호도를 로드합니다
- `CLAUDE.md` 프로필 섹션 — Claude Code에 의해 자동으로 인식됩니다

```bash
/gsd-profile-user                   # 세션 분석 및 프로필 구축
/gsd-profile-user --questionnaire   # 대화형 설문지 대체 방법
/gsd-profile-user --refresh         # 새로운 분석으로 재생성
```

### `/gsd-health`

`.planning/` 디렉터리의 무결성을 검사합니다.

| 플래그 | 설명 |
|--------|------|
| `--repair` | 복구 가능한 문제를 자동으로 수정합니다 |

```bash
/gsd-health                         # 무결성 검사
/gsd-health --repair                # 검사 및 수정
```

### `/gsd-cleanup`

완료된 마일스톤의 누적된 페이즈 디렉터리를 아카이브합니다.

```bash
/gsd-cleanup
```

---

## 진단 명령어

### `/gsd-forensics`

실패하거나 멈춘 GSD 워크플로우에 대한 사후 조사를 수행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `description` | 아니오 | 문제 설명 (생략 시 프롬프트로 입력) |

**사전 조건:** `.planning/` 디렉터리가 존재해야 합니다.
**생성 파일:** `.planning/forensics/report-{timestamp}.md`

**조사 항목.**
- Git 히스토리 분석 (최근 커밋, 멈춤 패턴, 시간 간격)
- 아티팩트 무결성 (완료된 페이즈에 대한 예상 파일)
- STATE.md 이상 및 세션 히스토리
- 커밋되지 않은 작업, 충돌, 방치된 변경사항
- 최소 4가지 이상 유형 검사 (멈춤 루프, 누락된 아티팩트, 방치된 작업, 충돌/중단)
- 실행 가능한 발견사항이 있으면 GitHub 이슈 생성 제안

```bash
/gsd-forensics                              # 대화형 — 문제 입력 프롬프트
/gsd-forensics "Phase 3 execution stalled"  # 문제 설명과 함께 실행
```

---

## 워크스트림 관리

### `/gsd-workstreams`

마일스톤의 서로 다른 영역에 대한 동시 작업을 위한 병렬 워크스트림을 관리합니다.

**서브커맨드.**

| 서브커맨드 | 설명 |
|------------|------|
| `list` | 상태와 함께 모든 워크스트림 목록 (서브커맨드 없을 경우 기본값) |
| `create <name>` | 새 워크스트림 생성 |
| `status <name>` | 특정 워크스트림의 상세 상태 |
| `switch <name>` | 활성 워크스트림 설정 |
| `progress` | 모든 워크스트림의 진행 상황 요약 |
| `complete <name>` | 완료된 워크스트림 아카이브 |
| `resume <name>` | 워크스트림의 작업 재개 |

**사전 조건:** 활성 GSD 프로젝트
**생성 파일:** `.planning/` 하위의 워크스트림 디렉터리, 워크스트림별 상태 추적

```bash
/gsd-workstreams                    # 모든 워크스트림 목록
/gsd-workstreams create backend-api # 새 워크스트림 생성
/gsd-workstreams switch backend-api # 활성 워크스트림 설정
/gsd-workstreams status backend-api # 상세 상태 확인
/gsd-workstreams progress           # 교차 워크스트림 진행 상황 개요
/gsd-workstreams complete backend-api  # 완료된 워크스트림 아카이브
/gsd-workstreams resume backend-api    # 워크스트림 작업 재개
```

---

## 설정 명령어

### `/gsd-settings`

워크플로우 토글 및 모델 프로필의 대화형 설정을 합니다.

```bash
/gsd-settings                       # 대화형 설정
```

### `/gsd-set-profile`

프로필을 빠르게 전환합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `profile` | **예** | `quality`, `balanced`, `budget`, 또는 `inherit` |

```bash
/gsd-set-profile budget             # 예산 프로필로 전환
/gsd-set-profile quality            # 품질 프로필로 전환
```

---

## 브라운필드 명령어

### `/gsd-map-codebase`

병렬 매퍼 에이전트를 사용하여 기존 코드베이스를 분석합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `area` | 아니오 | 특정 영역으로 매핑 범위를 제한합니다 |

```bash
/gsd-map-codebase                   # 전체 코드베이스 분석
/gsd-map-codebase auth              # 인증 영역에 집중
```

---

## 업데이트 명령어

### `/gsd-update`

변경 로그 미리보기와 함께 GSD를 업데이트합니다.

```bash
/gsd-update                         # 업데이트 확인 및 설치
```

### `/gsd-reapply-patches`

GSD 업데이트 후 로컬 수정사항을 복원합니다.

```bash
/gsd-reapply-patches                # 로컬 변경사항 병합
```

---

## 빠른 인라인 명령어

### `/gsd-fast`

서브에이전트나 계획 오버헤드 없이 간단한 작업을 인라인으로 실행합니다. 오타 수정, 설정 변경, 소규모 리팩터링, 누락된 커밋에 적합합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `task description` | 아니오 | 수행할 작업 (생략 시 프롬프트로 입력) |

**`/gsd-quick`의 대체가 아닙니다.** 조사, 다단계 계획 또는 검증이 필요한 작업에는 `/gsd-quick`을 사용하세요.

```bash
/gsd-fast "fix typo in README"
/gsd-fast "add .env to gitignore"
```

---

## 코드 품질 명령어

### `/gsd-review`

외부 AI CLI를 통한 페이즈 계획의 교차 AI 동료 리뷰를 수행합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `--phase N` | **예** | 리뷰할 페이즈 번호 |

| 플래그 | 설명 |
|--------|------|
| `--gemini` | Gemini CLI 리뷰 포함 |
| `--claude` | Claude CLI 리뷰 포함 (별도 세션) |
| `--codex` | Codex CLI 리뷰 포함 |
| `--coderabbit` | CodeRabbit 리뷰 포함 |
| `--opencode` | OpenCode 리뷰 포함 (GitHub Copilot 경유) |
| `--qwen` | Qwen Code 리뷰 포함 (Alibaba Qwen 모델) |
| `--cursor` | Cursor 에이전트 리뷰 포함 |
| `--all` | 사용 가능한 모든 CLI 포함 |

**생성 파일:** `{phase}-REVIEWS.md` — `/gsd-plan-phase --reviews`에서 사용 가능

```bash
/gsd-review --phase 3 --all
/gsd-review --phase 2 --gemini
```

---

### `/gsd-pr-branch`

`.planning/` 커밋을 필터링한 깔끔한 PR 브랜치를 생성합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `target branch` | 아니오 | 기본 브랜치 (기본값: `main`) |

**목적:** 리뷰어에게 GSD 계획 아티팩트가 아닌 코드 변경사항만 표시합니다.

```bash
/gsd-pr-branch                     # main을 기준으로 필터링
/gsd-pr-branch develop             # develop을 기준으로 필터링
```

---

### `/gsd-audit-uat`

모든 미완료 UAT 및 검증 항목에 대한 교차 페이즈 감사를 수행합니다.

**사전 조건:** UAT 또는 검증이 포함된 페이즈가 하나 이상 실행되어 있어야 합니다.
**생성 파일:** 사람이 직접 수행하는 테스트 계획이 포함된 분류된 감사 보고서

```bash
/gsd-audit-uat
```

---

## 백로그 및 스레드 명령어

### `/gsd-add-backlog`

999.x 번호 체계를 사용하여 백로그 파킹 롯에 아이디어를 추가합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `description` | **예** | 백로그 항목 설명 |

**999.x 번호 체계**는 백로그 항목을 활성 페이즈 순서 밖에 유지합니다. 페이즈 디렉터리가 즉시 생성되므로 해당 항목에 대해 `/gsd-discuss-phase`와 `/gsd-plan-phase`를 사용할 수 있습니다.

```bash
/gsd-add-backlog "GraphQL API layer"
/gsd-add-backlog "Mobile responsive redesign"
```

---

### `/gsd-review-backlog`

백로그 항목을 검토하고 활성 마일스톤으로 승격합니다.

**항목별 작업:** 승격 (활성 순서로 이동), 유지 (백로그에 남김), 제거 (삭제).

```bash
/gsd-review-backlog
```

---

### `/gsd-plant-seed`

트리거 조건이 있는 미래 지향적인 아이디어를 캡처합니다. 적절한 마일스톤 시점에 자동으로 표면화됩니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `idea summary` | 아니오 | 시드 설명 (생략 시 프롬프트로 입력) |

시드는 컨텍스트 부식 문제를 해결합니다. 아무도 읽지 않는 Deferred의 한 줄짜리 메모 대신, 시드는 전체 WHY, 언제 표면화할지, 세부 내용에 대한 단서를 보존합니다.

**생성 파일:** `.planning/seeds/SEED-NNN-slug.md`
**사용처:** `/gsd-new-milestone` (시드를 스캔하여 일치 항목 제시)

```bash
/gsd-plant-seed "Add real-time collaboration when WebSocket infra is in place"
```

---

### `/gsd-thread`

교차 세션 작업을 위한 지속적인 컨텍스트 스레드를 관리합니다.

| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| (없음) | — | 모든 스레드 목록 |
| `name` | — | 이름으로 기존 스레드 재개 |
| `description` | — | 새 스레드 생성 |

스레드는 여러 세션에 걸쳐 이어지지만 특정 페이즈에 속하지 않는 작업을 위한 경량 교차 세션 지식 저장소입니다. `/gsd-pause-work`보다 가볍습니다.

```bash
/gsd-thread                         # 모든 스레드 목록
/gsd-thread fix-deploy-key-auth     # 스레드 재개
/gsd-thread "Investigate TCP timeout in pasta service"  # 새 스레드 생성
```

---

## 커뮤니티 명령어

### `/gsd-join-discord`

Discord 커뮤니티 초대 링크를 엽니다.

```bash
/gsd-join-discord
```
