fix: replace /gsd: slash command format with /gsd- skill format in all user-facing content (#1579)

* fix: replace /gsd: command format with /gsd- skill format in all suggestions

All next-step suggestions shown to users were still using the old colon
format (/gsd:xxx) which cannot be copy-pasted as skills. Migrated all
occurrences across agents/, commands/, get-shit-done/, docs/, README files,
bin/install.js (hardcoded defaults for claude runtime), and
get-shit-done/bin/lib/*.cjs (generate-claude-md templates and error messages).
Updated tests to assert new hyphen format instead of old colon format.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: migrate remaining /gsd: format to /gsd- in hooks, workflows, and sdk

Addresses remaining user-facing occurrences missed in the initial migration:

- hooks/: fix 4 user-facing messages (pause-work, update, fast, quick)
  and 2 comments in gsd-workflow-guard.js
- get-shit-done/workflows/: fix 21 Skill() literal calls that Claude
  executes directly (installer does not transform workflow content)
- sdk/prompt-sanitizer.ts: update regex to strip /gsd- format in addition
  to legacy /gsd: format; update JSDoc comment
- tests/: update autonomous-ui-steps, prompt-sanitizer to assert new format

Note: commands/gsd/*.md frontmatter (name: gsd:xxx) intentionally unchanged
— installer derives skillName from directory path, not the name field.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(plan-phase): preserve --chain flag in auto-advance sync and handle ui-phase gate in chain mode

Bug 1: step 15 sync-flag check only guarded against --auto, causing
_auto_chain_active to be cleared when plan-phase is invoked without
--auto in ARGUMENTS even though a --chain pipeline was active. Added
--chain to the guard condition, matching discuss-phase behaviour.

Bug 2: UI Design Contract gate (step 5.6) always exited the workflow
when UI-SPEC was missing, breaking the discuss --chain pipeline
silently. When _auto_chain_active is true, the gate now auto-invokes
gsd-ui-phase --auto via Skill() and continues to step 6 without
prompting. Manual invocations retain the existing AskUserQuestion flow.

* fix: remove <sub>/clear</sub> pattern and duplicate old-format command in discuss-phase.md

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Quang Do
2026-04-04 18:24:31 +07:00
committed by GitHub
parent 05e35ac09a
commit d4767ac2e0
173 changed files with 3461 additions and 3419 deletions

View File

@@ -34,7 +34,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:new-project`, `/gsd:new-milestone` |
| **생성 주체** | `/gsd-new-project`, `/gsd-new-milestone` |
| **병렬성** | 4개 인스턴스 (stack, features, architecture, pitfalls) |
| **도구** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **모델 (balanced)** | Sonnet |
@@ -53,7 +53,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:plan-phase` |
| **생성 주체** | `/gsd-plan-phase` |
| **병렬성** | 4개 인스턴스 (project-researcher와 동일한 집중 영역) |
| **도구** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **모델 (balanced)** | Sonnet |
@@ -72,7 +72,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:ui-phase` |
| **생성 주체** | `/gsd-ui-phase` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **모델 (balanced)** | Sonnet |
@@ -138,7 +138,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:new-project` (4개 조사자 완료 후) |
| **생성 주체** | `/gsd-new-project` (4개 조사자 완료 후) |
| **병렬성** | 단일 인스턴스 (조사자 이후 순차적) |
| **도구** | Read, Write, Bash |
| **모델 (balanced)** | Sonnet |
@@ -153,7 +153,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:plan-phase`, `/gsd:quick` |
| **생성 주체** | `/gsd-plan-phase`, `/gsd-quick` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Bash, Glob, Grep, WebFetch, mcp (context7) |
| **모델 (balanced)** | Opus |
@@ -175,7 +175,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:new-project` |
| **생성 주체** | `/gsd-new-project` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Bash, Glob, Grep |
| **모델 (balanced)** | Sonnet |
@@ -196,7 +196,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:execute-phase`, `/gsd:quick` |
| **생성 주체** | `/gsd-execute-phase`, `/gsd-quick` |
| **병렬성** | 복수 (웨이브 내 병렬, 웨이브 간 순차적) |
| **도구** | Read, Write, Edit, Bash, Grep, Glob |
| **모델 (balanced)** | Sonnet |
@@ -219,7 +219,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:plan-phase` (검증 루프, 최대 3회 반복) |
| **생성 주체** | `/gsd-plan-phase` (검증 루프, 최대 3회 반복) |
| **병렬성** | 단일 인스턴스 (반복적) |
| **도구** | Read, Bash, Glob, Grep |
| **모델 (balanced)** | Sonnet |
@@ -244,7 +244,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:audit-milestone` |
| **생성 주체** | `/gsd-audit-milestone` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Bash, Grep, Glob |
| **모델 (balanced)** | Sonnet |
@@ -259,7 +259,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:ui-phase` (검증 루프, 최대 2회 반복) |
| **생성 주체** | `/gsd-ui-phase` (검증 루프, 최대 2회 반복) |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Bash, Glob, Grep |
| **모델 (balanced)** | Sonnet |
@@ -274,7 +274,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:execute-phase` (모든 executor 완료 후) |
| **생성 주체** | `/gsd-execute-phase` (모든 executor 완료 후) |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Bash, Grep, Glob |
| **모델 (balanced)** | Sonnet |
@@ -284,7 +284,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
**핵심 동작.**
- 작업 완료 여부가 아닌 단계 목표에 대해 코드베이스를 확인합니다
- 구체적인 증거를 포함한 PASS/FAIL 결과를 제공합니다
- `/gsd:verify-work`가 처리할 문제를 기록합니다
- `/gsd-verify-work`가 처리할 문제를 기록합니다
---
@@ -294,7 +294,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:validate-phase` |
| **생성 주체** | `/gsd-validate-phase` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Edit, Bash, Grep, Glob |
| **모델 (balanced)** | Sonnet |
@@ -313,7 +313,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:ui-review` |
| **생성 주체** | `/gsd-ui-review` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read, Write, Bash, Grep, Glob |
| **모델 (balanced)** | Sonnet |
@@ -336,7 +336,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:map-codebase` |
| **생성 주체** | `/gsd-map-codebase` |
| **병렬성** | 4개 인스턴스 (tech, architecture, quality, concerns) |
| **도구** | Read, Bash, Grep, Glob, Write |
| **모델 (balanced)** | Haiku |
@@ -356,7 +356,7 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:debug`, `/gsd:verify-work` (실패 시) |
| **생성 주체** | `/gsd-debug`, `/gsd-verify-work` (실패 시) |
| **병렬성** | 단일 인스턴스 (대화형) |
| **도구** | Read, Write, Edit, Bash, Grep, Glob, WebSearch |
| **모델 (balanced)** | Sonnet |
@@ -381,12 +381,12 @@ GSD는 멀티 에이전트 아키텍처를 사용합니다. 가벼운 오케스
| 속성 | 값 |
|----------|-------|
| **생성 주체** | `/gsd:profile-user` |
| **생성 주체** | `/gsd-profile-user` |
| **병렬성** | 단일 인스턴스 |
| **도구** | Read |
| **모델 (balanced)** | Sonnet |
| **색상** | Magenta |
| **생성물** | `USER-PROFILE.md`, `/gsd:dev-preferences`, `CLAUDE.md` 프로필 섹션 |
| **생성물** | `USER-PROFILE.md`, `/gsd-dev-preferences`, `CLAUDE.md` 프로필 섹션 |
**행동 차원.**
커뮤니케이션 스타일, 결정 패턴, 디버깅 접근 방식, UX 선호도, 벤더 선택, 불만 요인, 학습 스타일, 설명 깊이.

View File

@@ -31,7 +31,7 @@ GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Ki
```
┌──────────────────────────────────────────────────────┐
│ USER │
│ /gsd:command [args] │
│ /gsd-command [args] │
└─────────────────────┬────────────────────────────────┘
│
┌─────────────────────▼────────────────────────────────┐
@@ -107,10 +107,10 @@ GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Ki
### Commands (`commands/gsd/*.md`)
사용자 대면 진입점입니다. 각 파일은 YAML 전문(name, description, allowed-tools)과 워크플로우를 부트스트랩하는 프롬프트 본문을 포함합니다. 명령어는 다음과 같이 설치됩니다.
- **Claude Code:** 커스텀 슬래시 명령어 (`/gsd:command-name`)
- **Claude Code:** 커스텀 슬래시 명령어 (`/gsd-command-name`)
- **OpenCode / Kilo:** 슬래시 명령어 (`/gsd-command-name`)
- **Codex:** Skills (`$gsd-command-name`)
- **Copilot:** 슬래시 명령어 (`/gsd:command-name`)
- **Copilot:** 슬래시 명령어 (`/gsd-command-name`)
- **Antigravity:** Skills
**전체 명령어 수:** 44개
@@ -378,13 +378,13 @@ UI-SPEC.md (per phase) ───────────────────
├── STATE.md # 살아있는 메모리: 위치, 결정, 차단, 메트릭
├── config.json # 워크플로우 설정
├── MILESTONES.md # 완료된 마일스톤 보관
├── research/ # /gsd:new-project의 도메인 조사
├── research/ # /gsd-new-project의 도메인 조사
│ ├── SUMMARY.md
│ ├── STACK.md
│ ├── FEATURES.md
│ ├── ARCHITECTURE.md
│ └── PITFALLS.md
├── codebase/ # 브라운필드 매핑 (/gsd:map-codebase에서)
├── codebase/ # 브라운필드 매핑 (/gsd-map-codebase에서)
│ ├── STACK.md
│ ├── ARCHITECTURE.md
│ ├── CONVENTIONS.md
@@ -410,13 +410,13 @@ UI-SPEC.md (per phase) ───────────────────
├── todos/
│ ├── pending/ # 캡처된 아이디어
│ └── done/ # 완료된 할 일
├── threads/ # 영구 컨텍스트 스레드 (/gsd:thread에서)
├── seeds/ # 미래 지향적 아이디어 (/gsd:plant-seed에서)
├── threads/ # 영구 컨텍스트 스레드 (/gsd-thread에서)
├── seeds/ # 미래 지향적 아이디어 (/gsd-plant-seed에서)
├── debug/ # 활성 디버그 세션
│ ├── *.md # 활성 세션
│ ├── resolved/ # 보관된 세션
│ └── knowledge-base.md # 영구 디버그 학습 내용
├── ui-reviews/ # /gsd:ui-review의 스크린샷 (gitignored)
├── ui-reviews/ # /gsd-ui-review의 스크린샷 (gitignored)
└── continue-here.md # 컨텍스트 핸드오프 (pause-work에서)
```
@@ -439,7 +439,7 @@ UI-SPEC.md (per phase) ───────────────────
- Antigravity: Google 모델 등가물을 사용한 skills-first 방식
5. **경로 정규화** — `~/.claude/` 경로를 런타임별 경로로 교체
6. **설정 통합** — 런타임의 `settings.json`에 훅 등록
7. **패치 백업** — v1.17부터 로컬 수정 파일을 `gsd-local-patches/`에 백업하여 `/gsd:reapply-patches`에 사용
7. **패치 백업** — v1.17부터 로컬 수정 파일을 `gsd-local-patches/`에 백업하여 `/gsd-reapply-patches`에 사용
8. **매니페스트 추적** — 깔끔한 제거를 위해 `gsd-file-manifest.json` 작성
9. **제거 모드** — `--uninstall`로 모든 GSD 파일, 훅, 설정 제거
@@ -499,8 +499,8 @@ Runtime Engine (Claude Code / Gemini CLI)
**Workflow Guard** (`gsd-workflow-guard.js`).
- `.planning/` 외부 파일에 Write/Edit 시 트리거됩니다
- GSD 워크플로우 컨텍스트 외부의 편집을 감지합니다 (활성 `/gsd:` 명령어 또는 Task 서브에이전트 없음)
- 상태 추적 변경을 위해 `/gsd:quick` 또는 `/gsd:fast` 사용을 권고합니다
- GSD 워크플로우 컨텍스트 외부의 편집을 감지합니다 (활성 `/gsd-` 명령어 또는 Task 서브에이전트 없음)
- 상태 추적 변경을 위해 `/gsd-quick` 또는 `/gsd-fast` 사용을 권고합니다
- `hooks.workflow_guard: true`로 활성화 (기본값: false)
---
@@ -511,12 +511,12 @@ GSD는 통합된 명령어/워크플로우 아키텍처를 통해 여러 AI 코
| 런타임 | 명령어 형식 | 에이전트 시스템 | 설정 위치 |
|---------|---------------|--------------|-----------------|
| Claude Code | `/gsd:command` | Task 생성 | `~/.claude/` |
| Claude Code | `/gsd-command` | Task 생성 | `~/.claude/` |
| OpenCode | `/gsd-command` | Subagent 모드 | `~/.config/opencode/` |
| Kilo | `/gsd-command` | Subagent 모드 | `~/.config/kilo/` |
| Gemini CLI | `/gsd:command` | Task 생성 | `~/.gemini/` |
| Gemini CLI | `/gsd-command` | Task 생성 | `~/.gemini/` |
| Codex | `$gsd-command` | Skills | `~/.codex/` |
| Copilot | `/gsd:command` | 에이전트 위임 | `~/.github/` |
| Copilot | `/gsd-command` | 에이전트 위임 | `~/.github/` |
| Antigravity | Skills | Skills | `~/.gemini/antigravity/` |
### 추상화 포인트

View File

@@ -6,7 +6,7 @@
## 명령어 문법
- **Claude Code / Gemini / Copilot:** `/gsd:command-name [args]`
- **Claude Code / Gemini / Copilot:** `/gsd-command-name [args]`
- **OpenCode / Kilo:** `/gsd-command-name [args]`
- **Codex:** `$gsd-command-name [args]`
@@ -14,7 +14,7 @@
## 핵심 워크플로우 명령어
### `/gsd:new-project`
### `/gsd-new-project`
심층 컨텍스트 수집을 통해 새 프로젝트를 초기화합니다.
@@ -26,13 +26,13 @@
**생성 파일:** `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-project # 대화형 모드
/gsd-new-project --auto @prd.md # PRD에서 자동 추출
```
---
### `/gsd:new-workspace`
### `/gsd-new-workspace`
격리된 워크스페이스를 생성합니다. 저장소 복사본과 독립적인 `.planning/` 디렉터리가 포함됩니다.
@@ -52,14 +52,14 @@
**생성 파일:** `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-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-list-workspaces`
활성 GSD 워크스페이스와 상태를 목록으로 표시합니다.
@@ -67,12 +67,12 @@
**표시 항목:** 이름, 저장소 수, 전략, GSD 프로젝트 상태
```bash
/gsd:list-workspaces
/gsd-list-workspaces
```
---
### `/gsd:remove-workspace`
### `/gsd-remove-workspace`
워크스페이스를 제거하고 git worktree를 정리합니다.
@@ -83,12 +83,12 @@
**안전 장치:** 저장소에 커밋되지 않은 변경사항이 있으면 제거를 거부합니다. 이름 확인이 필요합니다.
```bash
/gsd:remove-workspace feature-b
/gsd-remove-workspace feature-b
```
---
### `/gsd:discuss-phase`
### `/gsd-discuss-phase`
계획 수립 전에 구현 결정사항을 캡처합니다.
@@ -106,15 +106,15 @@
**생성 파일:** `{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-discuss-phase 1 # 페이즈 1 대화형 토론
/gsd-discuss-phase 3 --auto # 페이즈 3 기본값 자동 선택
/gsd-discuss-phase --batch # 현재 페이즈 일괄 모드
/gsd-discuss-phase 2 --analyze # 트레이드오프 분석 포함 토론
```
---
### `/gsd:ui-phase`
### `/gsd-ui-phase`
프론트엔드 페이즈를 위한 UI 설계 계약을 생성합니다.
@@ -126,12 +126,12 @@
**생성 파일:** `{phase}-UI-SPEC.md`
```bash
/gsd:ui-phase 2 # 페이즈 2 설계 계약 생성
/gsd-ui-phase 2 # 페이즈 2 설계 계약 생성
```
---
### `/gsd:plan-phase`
### `/gsd-plan-phase`
페이즈를 조사하고 계획하며 검증합니다.
@@ -153,14 +153,14 @@
**생성 파일:** `{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-plan-phase 1 # 페이즈 1 조사 + 계획 + 검증
/gsd-plan-phase 3 --skip-research # 조사 없이 계획 (익숙한 도메인)
/gsd-plan-phase --auto # 비대화형 계획 수립
```
---
### `/gsd:execute-phase`
### `/gsd-execute-phase`
페이즈의 모든 계획을 웨이브 기반 병렬화로 실행하거나 특정 웨이브만 실행합니다.
@@ -173,13 +173,13 @@
**생성 파일:** 계획별 `{phase}-{N}-SUMMARY.md`, git 커밋, 페이즈가 완전히 완료되면 `{phase}-VERIFICATION.md`
```bash
/gsd:execute-phase 1 # 페이즈 1 실행
/gsd:execute-phase 1 --wave 2 # Wave 2만 실행
/gsd-execute-phase 1 # 페이즈 1 실행
/gsd-execute-phase 1 --wave 2 # Wave 2만 실행
```
---
### `/gsd:verify-work`
### `/gsd-verify-work`
자동 진단을 포함한 사용자 인수 테스트(UAT)를 수행합니다.
@@ -191,31 +191,31 @@
**생성 파일:** `{phase}-UAT.md`, 문제 발견 시 수정 계획
```bash
/gsd:verify-work 1 # 페이즈 1 UAT
/gsd-verify-work 1 # 페이즈 1 UAT
```
---
### `/gsd:next`
### `/gsd-next`
다음 논리적 워크플로우 단계로 자동으로 이동합니다. 프로젝트 상태를 읽고 적절한 명령어를 실행합니다.
**사전 조건:** `.planning/` 디렉터리가 존재해야 합니다.
**동작 방식.**
- 프로젝트 없음 → `/gsd:new-project` 제안
- 페이즈 토론 필요 → `/gsd:discuss-phase` 실행
- 페이즈 계획 필요 → `/gsd:plan-phase` 실행
- 페이즈 실행 필요 → `/gsd:execute-phase` 실행
- 페이즈 검증 필요 → `/gsd:verify-work` 실행
- 모든 페이즈 완료 → `/gsd:complete-milestone` 제안
- 프로젝트 없음 → `/gsd-new-project` 제안
- 페이즈 토론 필요 → `/gsd-discuss-phase` 실행
- 페이즈 계획 필요 → `/gsd-plan-phase` 실행
- 페이즈 실행 필요 → `/gsd-execute-phase` 실행
- 페이즈 검증 필요 → `/gsd-verify-work` 실행
- 모든 페이즈 완료 → `/gsd-complete-milestone` 제안
```bash
/gsd:next # 다음 단계 자동 감지 및 실행
/gsd-next # 다음 단계 자동 감지 및 실행
```
---
### `/gsd:session-report`
### `/gsd-session-report`
작업 요약, 결과, 예상 리소스 사용량을 포함한 세션 보고서를 생성합니다.
@@ -223,7 +223,7 @@
**생성 파일:** `.planning/reports/SESSION_REPORT.md`
```bash
/gsd:session-report # 세션 종료 후 요약 생성
/gsd-session-report # 세션 종료 후 요약 생성
```
**보고서 포함 내용.**
@@ -235,7 +235,7 @@
---
### `/gsd:ship`
### `/gsd-ship`
완료된 페이즈 작업으로부터 자동 생성된 본문이 포함된 PR을 만듭니다.
@@ -244,12 +244,12 @@
| `N` | 아니오 | 페이즈 번호 또는 마일스톤 버전 (예: `4` 또는 `v1.0`) |
| `--draft` | 아니오 | 초안 PR로 생성합니다 |
**사전 조건:** 페이즈 검증 완료 (`/gsd:verify-work` 통과), `gh` CLI 설치 및 인증
**사전 조건:** 페이즈 검증 완료 (`/gsd-verify-work` 통과), `gh` CLI 설치 및 인증
**생성 파일:** 계획 아티팩트 기반의 풍부한 본문이 포함된 GitHub PR, STATE.md 업데이트
```bash
/gsd:ship 4 # 페이즈 4 출시
/gsd:ship 4 --draft # 초안 PR로 출시
/gsd-ship 4 # 페이즈 4 출시
/gsd-ship 4 --draft # 초안 PR로 출시
```
**PR 본문 포함 내용.**
@@ -261,7 +261,7 @@
---
### `/gsd:ui-review`
### `/gsd-ui-review`
구현된 프론트엔드의 6개 기둥 기반 시각적 감사를 소급하여 수행합니다.
@@ -273,13 +273,13 @@
**생성 파일:** `{phase}-UI-REVIEW.md`, `.planning/ui-reviews/`에 스크린샷
```bash
/gsd:ui-review # 현재 페이즈 감사
/gsd:ui-review 3 # 페이즈 3 감사
/gsd-ui-review # 현재 페이즈 감사
/gsd-ui-review 3 # 페이즈 3 감사
```
---
### `/gsd:audit-uat`
### `/gsd-audit-uat`
모든 미완료 UAT 및 검증 항목에 대한 교차 페이즈 감사를 수행합니다.
@@ -287,12 +287,12 @@
**생성 파일:** 사람이 직접 수행하는 테스트 계획이 포함된 분류된 감사 보고서
```bash
/gsd:audit-uat
/gsd-audit-uat
```
---
### `/gsd:audit-milestone`
### `/gsd-audit-milestone`
마일스톤이 완료 정의를 충족했는지 검증합니다.
@@ -300,12 +300,12 @@
**생성 파일:** 갭 분석이 포함된 감사 보고서
```bash
/gsd:audit-milestone
/gsd-audit-milestone
```
---
### `/gsd:complete-milestone`
### `/gsd-complete-milestone`
마일스톤을 아카이브하고 릴리스 태그를 생성합니다.
@@ -313,12 +313,12 @@
**생성 파일:** `MILESTONES.md` 항목, git 태그
```bash
/gsd:complete-milestone
/gsd-complete-milestone
```
---
### `/gsd:milestone-summary`
### `/gsd-milestone-summary`
팀 온보딩 및 리뷰를 위해 마일스톤 아티팩트로부터 포괄적인 프로젝트 요약을 생성합니다.
@@ -338,13 +338,13 @@
- 생성 후 대화형 Q&A 제공
```bash
/gsd:milestone-summary # 현재 마일스톤 요약
/gsd:milestone-summary v1.0 # 특정 마일스톤 요약
/gsd-milestone-summary # 현재 마일스톤 요약
/gsd-milestone-summary v1.0 # 특정 마일스톤 요약
```
---
### `/gsd:new-milestone`
### `/gsd-new-milestone`
다음 버전 사이클을 시작합니다.
@@ -357,24 +357,24 @@
**생성 파일:** 업데이트된 `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-new-milestone # 대화형 모드
/gsd-new-milestone "v2.0 Mobile" # 이름이 지정된 마일스톤
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile" # 마일스톤 번호를 1부터 재시작
```
---
## 페이즈 관리 명령어
### `/gsd:add-phase`
### `/gsd-add-phase`
로드맵에 새 페이즈를 추가합니다.
```bash
/gsd:add-phase # 대화형 — 페이즈를 설명합니다
/gsd-add-phase # 대화형 — 페이즈를 설명합니다
```
### `/gsd:insert-phase`
### `/gsd-insert-phase`
소수점 번호 체계를 사용하여 페이즈 사이에 긴급 작업을 삽입합니다.
@@ -383,10 +383,10 @@
| `N` | 아니오 | 이 페이즈 번호 다음에 삽입합니다 |
```bash
/gsd:insert-phase 3 # 페이즈 3과 4 사이에 삽입 → 3.1 생성
/gsd-insert-phase 3 # 페이즈 3과 4 사이에 삽입 → 3.1 생성
```
### `/gsd:remove-phase`
### `/gsd-remove-phase`
미래 페이즈를 제거하고 이후 페이즈 번호를 재정렬합니다.
@@ -395,10 +395,10 @@
| `N` | 아니오 | 제거할 페이즈 번호 |
```bash
/gsd:remove-phase 7 # 페이즈 7 제거, 8→7, 9→8 등으로 재번호
/gsd-remove-phase 7 # 페이즈 7 제거, 8→7, 9→8 등으로 재번호
```
### `/gsd:list-phase-assumptions`
### `/gsd-list-phase-assumptions`
계획 수립 전 Claude의 예상 접근 방식을 미리 확인합니다.
@@ -407,30 +407,30 @@
| `N` | 아니오 | 페이즈 번호 |
```bash
/gsd:list-phase-assumptions 2 # 페이즈 2 가정 사항 확인
/gsd-list-phase-assumptions 2 # 페이즈 2 가정 사항 확인
```
### `/gsd:plan-milestone-gaps`
### `/gsd-plan-milestone-gaps`
마일스톤 감사에서 발견된 갭을 보완하는 페이즈를 생성합니다.
```bash
/gsd:plan-milestone-gaps # 각 감사 갭에 대한 페이즈 생성
/gsd-plan-milestone-gaps # 각 감사 갭에 대한 페이즈 생성
```
### `/gsd:research-phase`
### `/gsd-research-phase`
심층 에코시스템 조사만 수행합니다 (독립 실행 — 일반적으로 `/gsd:plan-phase`를 사용하세요).
심층 에코시스템 조사만 수행합니다 (독립 실행 — 일반적으로 `/gsd-plan-phase`를 사용하세요).
| 인수 | 필수 여부 | 설명 |
|------|----------|------|
| `N` | 아니오 | 페이즈 번호 |
```bash
/gsd:research-phase 4 # 페이즈 4 도메인 조사
/gsd-research-phase 4 # 페이즈 4 도메인 조사
```
### `/gsd:validate-phase`
### `/gsd-validate-phase`
Nyquist 검증 갭을 소급하여 감사하고 보완합니다.
@@ -439,38 +439,38 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다.
| `N` | 아니오 | 페이즈 번호 |
```bash
/gsd:validate-phase 2 # 페이즈 2 테스트 커버리지 감사
/gsd-validate-phase 2 # 페이즈 2 테스트 커버리지 감사
```
---
## 탐색 명령어
### `/gsd:progress`
### `/gsd-progress`
상태와 다음 단계를 표시합니다.
```bash
/gsd:progress # "지금 어디 있나? 다음은 무엇인가?"
/gsd-progress # "지금 어디 있나? 다음은 무엇인가?"
```
### `/gsd:resume-work`
### `/gsd-resume-work`
마지막 세션의 전체 컨텍스트를 복원합니다.
```bash
/gsd:resume-work # 컨텍스트 초기화 또는 새 세션 후 실행
/gsd-resume-work # 컨텍스트 초기화 또는 새 세션 후 실행
```
### `/gsd:pause-work`
### `/gsd-pause-work`
페이즈 중간에 중단할 때 컨텍스트 핸드오프를 저장합니다.
```bash
/gsd:pause-work # continue-here.md 생성
/gsd-pause-work # continue-here.md 생성
```
### `/gsd:manager`
### `/gsd-manager`
하나의 터미널에서 여러 페이즈를 관리하는 대화형 명령 센터입니다.
@@ -482,24 +482,24 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다.
- 하나의 터미널에서 여러 페이즈를 병렬로 처리하는 파워 유저를 위해 설계되었습니다
```bash
/gsd:manager # 명령 센터 대시보드 열기
/gsd-manager # 명령 센터 대시보드 열기
```
---
### `/gsd:help`
### `/gsd-help`
모든 명령어와 사용 가이드를 표시합니다.
```bash
/gsd:help # 빠른 레퍼런스
/gsd-help # 빠른 레퍼런스
```
---
## 유틸리티 명령어
### `/gsd:quick`
### `/gsd-quick`
GSD 보증을 갖춘 임시 작업을 실행합니다.
@@ -512,13 +512,13 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
플래그는 조합하여 사용할 수 있습니다.
```bash
/gsd:quick # 기본 빠른 작업
/gsd:quick --discuss --research # 토론 + 조사 + 계획
/gsd:quick --full # 계획 검사 및 검증 포함
/gsd:quick --discuss --research --full # 모든 선택적 단계 포함
/gsd-quick # 기본 빠른 작업
/gsd-quick --discuss --research # 토론 + 조사 + 계획
/gsd-quick --full # 계획 검사 및 검증 포함
/gsd-quick --discuss --research --full # 모든 선택적 단계 포함
```
### `/gsd:autonomous`
### `/gsd-autonomous`
남은 모든 페이즈를 자율적으로 실행합니다.
@@ -527,19 +527,19 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
| `--from N` | 특정 페이즈 번호부터 시작합니다 |
```bash
/gsd:autonomous # 남은 모든 페이즈 실행
/gsd:autonomous --from 3 # 페이즈 3부터 시작
/gsd-autonomous # 남은 모든 페이즈 실행
/gsd-autonomous --from 3 # 페이즈 3부터 시작
```
### `/gsd:do`
### `/gsd-do`
자유 형식 텍스트를 적절한 GSD 명령어로 라우팅합니다.
```bash
/gsd:do # 원하는 작업을 설명합니다
/gsd-do # 원하는 작업을 설명합니다
```
### `/gsd:note`
### `/gsd-note`
마찰 없는 아이디어 캡처 — 노트 추가, 목록 조회, 또는 노트를 할 일로 승격합니다.
@@ -554,12 +554,12 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
| `--global` | 노트 작업에 전역 범위 사용 |
```bash
/gsd:note "Consider caching strategy for API responses"
/gsd:note list
/gsd:note promote 3
/gsd-note "Consider caching strategy for API responses"
/gsd-note list
/gsd-note promote 3
```
### `/gsd:debug`
### `/gsd-debug`
지속적인 상태를 유지하는 체계적인 디버깅을 수행합니다.
@@ -568,10 +568,10 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
| `description` | 아니오 | 버그 설명 |
```bash
/gsd:debug "Login button not responding on mobile Safari"
/gsd-debug "Login button not responding on mobile Safari"
```
### `/gsd:add-todo`
### `/gsd-add-todo`
나중을 위한 아이디어나 작업을 캡처합니다.
@@ -580,18 +580,18 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
| `description` | 아니오 | 할 일 설명 |
```bash
/gsd:add-todo "Consider adding dark mode support"
/gsd-add-todo "Consider adding dark mode support"
```
### `/gsd:check-todos`
### `/gsd-check-todos`
보류 중인 할 일 목록을 표시하고 작업할 항목을 선택합니다.
```bash
/gsd:check-todos
/gsd-check-todos
```
### `/gsd:add-tests`
### `/gsd-add-tests`
완료된 페이즈에 대한 테스트를 생성합니다.
@@ -600,18 +600,18 @@ GSD 보증을 갖춘 임시 작업을 실행합니다.
| `N` | 아니오 | 페이즈 번호 |
```bash
/gsd:add-tests 2 # 페이즈 2 테스트 생성
/gsd-add-tests 2 # 페이즈 2 테스트 생성
```
### `/gsd:stats`
### `/gsd-stats`
프로젝트 통계를 표시합니다.
```bash
/gsd:stats # 프로젝트 지표 대시보드
/gsd-stats # 프로젝트 지표 대시보드
```
### `/gsd:profile-user`
### `/gsd-profile-user`
Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일, 의사결정 패턴, 디버깅 접근 방식, UX 선호도, 벤더 선택, 불만 유발 요인, 학습 스타일, 설명 깊이)으로 개발자 행동 프로필을 생성합니다. Claude의 응답을 개인화하는 아티팩트를 생성합니다.
@@ -622,16 +622,16 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
**생성 아티팩트.**
- `USER-PROFILE.md` — 전체 행동 프로필
- `/gsd:dev-preferences` 명령어 — 모든 세션에서 선호도를 로드합니다
- `/gsd-dev-preferences` 명령어 — 모든 세션에서 선호도를 로드합니다
- `CLAUDE.md` 프로필 섹션 — Claude Code에 의해 자동으로 인식됩니다
```bash
/gsd:profile-user # 세션 분석 및 프로필 구축
/gsd:profile-user --questionnaire # 대화형 설문지 대체 방법
/gsd:profile-user --refresh # 새로운 분석으로 재생성
/gsd-profile-user # 세션 분석 및 프로필 구축
/gsd-profile-user --questionnaire # 대화형 설문지 대체 방법
/gsd-profile-user --refresh # 새로운 분석으로 재생성
```
### `/gsd:health`
### `/gsd-health`
`.planning/` 디렉터리의 무결성을 검사합니다.
@@ -640,23 +640,23 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
| `--repair` | 복구 가능한 문제를 자동으로 수정합니다 |
```bash
/gsd:health # 무결성 검사
/gsd:health --repair # 검사 및 수정
/gsd-health # 무결성 검사
/gsd-health --repair # 검사 및 수정
```
### `/gsd:cleanup`
### `/gsd-cleanup`
완료된 마일스톤의 누적된 페이즈 디렉터리를 아카이브합니다.
```bash
/gsd:cleanup
/gsd-cleanup
```
---
## 진단 명령어
### `/gsd:forensics`
### `/gsd-forensics`
실패하거나 멈춘 GSD 워크플로우에 대한 사후 조사를 수행합니다.
@@ -676,15 +676,15 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
- 실행 가능한 발견사항이 있으면 GitHub 이슈 생성 제안
```bash
/gsd:forensics # 대화형 — 문제 입력 프롬프트
/gsd:forensics "Phase 3 execution stalled" # 문제 설명과 함께 실행
/gsd-forensics # 대화형 — 문제 입력 프롬프트
/gsd-forensics "Phase 3 execution stalled" # 문제 설명과 함께 실행
```
---
## 워크스트림 관리
### `/gsd:workstreams`
### `/gsd-workstreams`
마일스톤의 서로 다른 영역에 대한 동시 작업을 위한 병렬 워크스트림을 관리합니다.
@@ -704,28 +704,28 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
**생성 파일:** `.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-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`
### `/gsd-settings`
워크플로우 토글 및 모델 프로필의 대화형 설정을 합니다.
```bash
/gsd:settings # 대화형 설정
/gsd-settings # 대화형 설정
```
### `/gsd:set-profile`
### `/gsd-set-profile`
프로필을 빠르게 전환합니다.
@@ -734,15 +734,15 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
| `profile` | **예** | `quality`, `balanced`, `budget`, 또는 `inherit` |
```bash
/gsd:set-profile budget # 예산 프로필로 전환
/gsd:set-profile quality # 품질 프로필로 전환
/gsd-set-profile budget # 예산 프로필로 전환
/gsd-set-profile quality # 품질 프로필로 전환
```
---
## 브라운필드 명령어
### `/gsd:map-codebase`
### `/gsd-map-codebase`
병렬 매퍼 에이전트를 사용하여 기존 코드베이스를 분석합니다.
@@ -751,35 +751,35 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
| `area` | 아니오 | 특정 영역으로 매핑 범위를 제한합니다 |
```bash
/gsd:map-codebase # 전체 코드베이스 분석
/gsd:map-codebase auth # 인증 영역에 집중
/gsd-map-codebase # 전체 코드베이스 분석
/gsd-map-codebase auth # 인증 영역에 집중
```
---
## 업데이트 명령어
### `/gsd:update`
### `/gsd-update`
변경 로그 미리보기와 함께 GSD를 업데이트합니다.
```bash
/gsd:update # 업데이트 확인 및 설치
/gsd-update # 업데이트 확인 및 설치
```
### `/gsd:reapply-patches`
### `/gsd-reapply-patches`
GSD 업데이트 후 로컬 수정사항을 복원합니다.
```bash
/gsd:reapply-patches # 로컬 변경사항 병합
/gsd-reapply-patches # 로컬 변경사항 병합
```
---
## 빠른 인라인 명령어
### `/gsd:fast`
### `/gsd-fast`
서브에이전트나 계획 오버헤드 없이 간단한 작업을 인라인으로 실행합니다. 오타 수정, 설정 변경, 소규모 리팩터링, 누락된 커밋에 적합합니다.
@@ -787,18 +787,18 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
|------|----------|------|
| `task description` | 아니오 | 수행할 작업 (생략 시 프롬프트로 입력) |
**`/gsd:quick`의 대체가 아닙니다.** 조사, 다단계 계획 또는 검증이 필요한 작업에는 `/gsd:quick`을 사용하세요.
**`/gsd-quick`의 대체가 아닙니다.** 조사, 다단계 계획 또는 검증이 필요한 작업에는 `/gsd-quick`을 사용하세요.
```bash
/gsd:fast "fix typo in README"
/gsd:fast "add .env to gitignore"
/gsd-fast "fix typo in README"
/gsd-fast "add .env to gitignore"
```
---
## 코드 품질 명령어
### `/gsd:review`
### `/gsd-review`
외부 AI CLI를 통한 페이즈 계획의 교차 AI 동료 리뷰를 수행합니다.
@@ -814,16 +814,16 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
| `--coderabbit` | CodeRabbit 리뷰 포함 |
| `--all` | 사용 가능한 모든 CLI 포함 |
**생성 파일:** `{phase}-REVIEWS.md` — `/gsd:plan-phase --reviews`에서 사용 가능
**생성 파일:** `{phase}-REVIEWS.md` — `/gsd-plan-phase --reviews`에서 사용 가능
```bash
/gsd:review --phase 3 --all
/gsd:review --phase 2 --gemini
/gsd-review --phase 3 --all
/gsd-review --phase 2 --gemini
```
---
### `/gsd:pr-branch`
### `/gsd-pr-branch`
`.planning/` 커밋을 필터링한 깔끔한 PR 브랜치를 생성합니다.
@@ -834,13 +834,13 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
**목적:** 리뷰어에게 GSD 계획 아티팩트가 아닌 코드 변경사항만 표시합니다.
```bash
/gsd:pr-branch # main을 기준으로 필터링
/gsd:pr-branch develop # develop을 기준으로 필터링
/gsd-pr-branch # main을 기준으로 필터링
/gsd-pr-branch develop # develop을 기준으로 필터링
```
---
### `/gsd:audit-uat`
### `/gsd-audit-uat`
모든 미완료 UAT 및 검증 항목에 대한 교차 페이즈 감사를 수행합니다.
@@ -848,14 +848,14 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
**생성 파일:** 사람이 직접 수행하는 테스트 계획이 포함된 분류된 감사 보고서
```bash
/gsd:audit-uat
/gsd-audit-uat
```
---
## 백로그 및 스레드 명령어
### `/gsd:add-backlog`
### `/gsd-add-backlog`
999.x 번호 체계를 사용하여 백로그 파킹 롯에 아이디어를 추가합니다.
@@ -863,28 +863,28 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
|------|----------|------|
| `description` | **예** | 백로그 항목 설명 |
**999.x 번호 체계**는 백로그 항목을 활성 페이즈 순서 밖에 유지합니다. 페이즈 디렉터리가 즉시 생성되므로 해당 항목에 대해 `/gsd:discuss-phase`와 `/gsd:plan-phase`를 사용할 수 있습니다.
**999.x 번호 체계**는 백로그 항목을 활성 페이즈 순서 밖에 유지합니다. 페이즈 디렉터리가 즉시 생성되므로 해당 항목에 대해 `/gsd-discuss-phase`와 `/gsd-plan-phase`를 사용할 수 있습니다.
```bash
/gsd:add-backlog "GraphQL API layer"
/gsd:add-backlog "Mobile responsive redesign"
/gsd-add-backlog "GraphQL API layer"
/gsd-add-backlog "Mobile responsive redesign"
```
---
### `/gsd:review-backlog`
### `/gsd-review-backlog`
백로그 항목을 검토하고 활성 마일스톤으로 승격합니다.
**항목별 작업:** 승격 (활성 순서로 이동), 유지 (백로그에 남김), 제거 (삭제).
```bash
/gsd:review-backlog
/gsd-review-backlog
```
---
### `/gsd:plant-seed`
### `/gsd-plant-seed`
트리거 조건이 있는 미래 지향적인 아이디어를 캡처합니다. 적절한 마일스톤 시점에 자동으로 표면화됩니다.
@@ -895,15 +895,15 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
시드는 컨텍스트 부식 문제를 해결합니다. 아무도 읽지 않는 Deferred의 한 줄짜리 메모 대신, 시드는 전체 WHY, 언제 표면화할지, 세부 내용에 대한 단서를 보존합니다.
**생성 파일:** `.planning/seeds/SEED-NNN-slug.md`
**사용처:** `/gsd:new-milestone` (시드를 스캔하여 일치 항목 제시)
**사용처:** `/gsd-new-milestone` (시드를 스캔하여 일치 항목 제시)
```bash
/gsd:plant-seed "Add real-time collaboration when WebSocket infra is in place"
/gsd-plant-seed "Add real-time collaboration when WebSocket infra is in place"
```
---
### `/gsd:thread`
### `/gsd-thread`
교차 세션 작업을 위한 지속적인 컨텍스트 스레드를 관리합니다.
@@ -913,22 +913,22 @@ GSD 업데이트 후 로컬 수정사항을 복원합니다.
| `name` | — | 이름으로 기존 스레드 재개 |
| `description` | — | 새 스레드 생성 |
스레드는 여러 세션에 걸쳐 이어지지만 특정 페이즈에 속하지 않는 작업을 위한 경량 교차 세션 지식 저장소입니다. `/gsd:pause-work`보다 가볍습니다.
스레드는 여러 세션에 걸쳐 이어지지만 특정 페이즈에 속하지 않는 작업을 위한 경량 교차 세션 지식 저장소입니다. `/gsd-pause-work`보다 가볍습니다.
```bash
/gsd:thread # 모든 스레드 목록
/gsd:thread fix-deploy-key-auth # 스레드 재개
/gsd:thread "Investigate TCP timeout in pasta service" # 새 스레드 생성
/gsd-thread # 모든 스레드 목록
/gsd-thread fix-deploy-key-auth # 스레드 재개
/gsd-thread "Investigate TCP timeout in pasta service" # 새 스레드 생성
```
---
## 커뮤니티 명령어
### `/gsd:join-discord`
### `/gsd-join-discord`
Discord 커뮤니티 초대 링크를 엽니다.
```bash
/gsd:join-discord
/gsd-join-discord
```

View File

@@ -6,7 +6,7 @@
## 설정 파일
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:new-project` 실행 시 생성되며 `/gsd:settings`를 통해 업데이트할 수 있습니다.
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd-new-project` 실행 시 생성되며 `/gsd-settings`를 통해 업데이트할 수 있습니다.
### 전체 스키마
@@ -96,12 +96,12 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
| `workflow.auto_advance` | boolean | `false` | discuss → plan → execute를 중단 없이 자동으로 연결 |
| `workflow.nyquist_validation` | boolean | `true` | plan 단계 리서치 중 테스트 커버리지 매핑 |
| `workflow.ui_phase` | boolean | `true` | 프론트엔드 단계를 위한 UI 디자인 계약서 생성 |
| `workflow.ui_safety_gate` | boolean | `true` | plan 단계에서 프론트엔드 단계에 대해 /gsd:ui-phase 실행 여부 확인 |
| `workflow.ui_safety_gate` | boolean | `true` | plan 단계에서 프론트엔드 단계에 대해 /gsd-ui-phase 실행 여부 확인 |
| `workflow.node_repair` | boolean | `true` | 검증 실패 시 자율적 태스크 복구 |
| `workflow.node_repair_budget` | number | `2` | 실패한 태스크당 최대 복구 시도 횟수 |
| `workflow.research_before_questions` | boolean | `false` | 토론 질문 후가 아닌 전에 리서치 실행 |
| `workflow.discuss_mode` | string | `'discuss'` | `/gsd:discuss-phase`의 컨텍스트 수집 방식을 제어합니다. `'discuss'` (기본값)는 질문을 하나씩 합니다. `'assumptions'`는 코드베이스를 먼저 읽고 신뢰도 수준이 있는 구조화된 가정을 생성하여 틀린 부분만 수정하도록 요청합니다. v1.28에서 추가 |
| `workflow.skip_discuss` | boolean | `false` | `true`로 설정하면 `/gsd:autonomous`가 discuss 단계를 완전히 건너뛰고 ROADMAP 단계 목표로부터 최소한의 CONTEXT.md를 작성합니다. 개발자 선호사항이 PROJECT.md/REQUIREMENTS.md에 모두 캡처된 프로젝트에 유용합니다. v1.28에서 추가 |
| `workflow.discuss_mode` | string | `'discuss'` | `/gsd-discuss-phase`의 컨텍스트 수집 방식을 제어합니다. `'discuss'` (기본값)는 질문을 하나씩 합니다. `'assumptions'`는 코드베이스를 먼저 읽고 신뢰도 수준이 있는 구조화된 가정을 생성하여 틀린 부분만 수정하도록 요청합니다. v1.28에서 추가 |
| `workflow.skip_discuss` | boolean | `false` | `true`로 설정하면 `/gsd-autonomous`가 discuss 단계를 완전히 건너뛰고 ROADMAP 단계 목표로부터 최소한의 CONTEXT.md를 작성합니다. 개발자 선호사항이 PROJECT.md/REQUIREMENTS.md에 모두 캡처된 프로젝트에 유용합니다. v1.28에서 추가 |
| `workflow.text_mode` | boolean | `false` | AskUserQuestion TUI 메뉴를 일반 텍스트 번호 목록으로 대체합니다. TUI 메뉴가 렌더링되지 않는 Claude Code 원격 세션 (`/rc` 모드)에 필요합니다. discuss 단계에서 `--text` 플래그로 세션별 설정도 가능합니다. v1.28에서 추가 |
### 권장 프리셋
@@ -132,7 +132,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
| 설정 | 타입 | 기본값 | 설명 |
|------|------|--------|------|
| `hooks.context_warnings` | boolean | `true` | context monitor 훅을 통해 컨텍스트 윈도우 사용 경고 표시 |
| `hooks.workflow_guard` | boolean | `false` | GSD 워크플로우 컨텍스트 밖에서 파일 편집이 발생할 때 경고 ((`/gsd:quick` 또는 `/gsd:fast` 사용 권고)) |
| `hooks.workflow_guard` | boolean | `false` | GSD 워크플로우 컨텍스트 밖에서 파일 편집이 발생할 때 경고 ((`/gsd-quick` 또는 `/gsd-fast` 사용 권고)) |
프롬프트 주입 방지 훅 (`gsd-prompt-guard.js`)은 항상 활성화되며 비활성화할 수 없습니다. 워크플로우 토글이 아닌 보안 기능입니다.
@@ -168,7 +168,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
| `git.branching_strategy` | enum | `none` | `none`, `phase`, 또는 `milestone` |
| `git.phase_branch_template` | string | `gsd/phase-{phase}-{slug}` | phase 전략의 브랜치 이름 템플릿 |
| `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | milestone 전략의 브랜치 이름 템플릿 |
| `git.quick_branch_template` | string 또는 null | `null` | `/gsd:quick` 태스크를 위한 선택적 브랜치 이름 템플릿 |
| `git.quick_branch_template` | string 또는 null | `null` | `/gsd-quick` 태스크를 위한 선택적 브랜치 이름 템플릿 |
### 전략 비교
@@ -339,4 +339,4 @@ quick 태스크 브랜칭 예시:
**위치:** `~/.gsd/defaults.json`
`/gsd:new-project`가 새 `config.json`을 생성할 때 전역 기본값을 읽어 초기 설정으로 병합합니다. 프로젝트별 설정은 항상 전역 설정보다 우선합니다.
`/gsd-new-project`가 새 `config.json`을 생성할 때 전역 기본값을 읽어 초기 설정으로 병합합니다. 프로젝트별 설정은 항상 전역 설정보다 우선합니다.

View File

@@ -77,7 +77,7 @@
### 1. Project Initialization
**명령어:** `/gsd:new-project [--auto @file.md]`
**명령어:** `/gsd-new-project [--auto @file.md]`
**목적:** 사용자의 아이디어를 연구, 범위가 지정된 요구사항, 단계별 로드맵을 갖춘 완전히 구조화된 프로젝트로 전환합니다.
@@ -116,13 +116,13 @@
- 연구 에이전트는 현재 생태계 정보를 위한 웹 검색 기능을 갖추고 있습니다.
- 세분화 설정으로 페이즈 수를 제어합니다. `coarse`(3-5), `standard`(5-8), `fine`(8-12)
- `--auto` 모드는 대화형 질문 없이 제공된 문서에서 모든 정보를 추출합니다.
- 기존 코드베이스 컨텍스트(`/gsd:map-codebase`에서)가 있으면 로드됩니다.
- 기존 코드베이스 컨텍스트(`/gsd-map-codebase`에서)가 있으면 로드됩니다.
---
### 2. Phase Discussion
**명령어:** `/gsd:discuss-phase [N] [--auto] [--batch]`
**명령어:** `/gsd-discuss-phase [N] [--auto] [--batch]`
**목적:** 연구와 계획이 시작되기 전에 사용자의 구현 선호도와 결정을 캡처합니다. AI가 추측하게 만드는 회색 지대를 제거합니다.
@@ -149,7 +149,7 @@
### 3. UI Design Contract
**명령어:** `/gsd:ui-phase [N]`
**명령어:** `/gsd-ui-phase [N]`
**목적:** 계획 전에 설계 결정을 확정하여 페이즈 내 모든 컴포넌트가 일관된 시각적 기준을 공유하도록 합니다.
@@ -181,7 +181,7 @@
### 4. Phase Planning
**명령어:** `/gsd:plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
**명령어:** `/gsd-plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
**목적:** 구현 도메인을 연구하고 검증된 원자적 실행 계획을 생성합니다.
@@ -192,7 +192,7 @@
- REQ-PLAN-04: 모든 계획에 `read_first`와 `acceptance_criteria` 섹션을 포함해야 합니다.
- REQ-PLAN-05: `--skip-verify`가 설정되지 않은 경우 계획 검사기 검증 루프를 실행해야 합니다(최대 3회 반복).
- REQ-PLAN-06: 연구 단계를 건너뛰는 `--skip-research` 플래그를 지원해야 합니다.
- REQ-PLAN-07: 프론트엔드 페이즈가 감지되고 UI-SPEC.md가 없는 경우 `/gsd:ui-phase` 실행을 촉구해야 합니다(UI 안전 게이트).
- REQ-PLAN-07: 프론트엔드 페이즈가 감지되고 UI-SPEC.md가 없는 경우 `/gsd-ui-phase` 실행을 촉구해야 합니다(UI 안전 게이트).
- REQ-PLAN-08: `workflow.nyquist_validation`이 활성화된 경우 Nyquist 유효성 검사 매핑을 포함해야 합니다.
- REQ-PLAN-09: 계획이 완료되기 전에 모든 페이즈 요구사항이 최소 하나의 계획에 포함되어 있는지 확인해야 합니다(요구사항 커버리지 게이트).
@@ -231,7 +231,7 @@
### 5. Phase Execution
**명령어:** `/gsd:execute-phase <N>`
**명령어:** `/gsd-execute-phase <N>`
**목적:** 실행자별 새로운 컨텍스트 창을 사용한 웨이브 기반 병렬화로 페이즈의 모든 계획을 실행합니다.
@@ -275,7 +275,7 @@
### 6. Work Verification
**명령어:** `/gsd:verify-work [N]`
**명령어:** `/gsd-verify-work [N]`
**목적:** 사용자 인수 테스트 — 각 결과물을 테스트하는 과정을 사용자와 함께 진행하고 실패를 자동으로 진단합니다.
@@ -293,7 +293,7 @@
### 6.5. Ship
**명령어:** `/gsd:ship [N] [--draft]`
**명령어:** `/gsd-ship [N] [--draft]`
**목적:** 로컬 완료에서 병합된 PR로의 전환. 검증 통과 후 브랜치를 푸시하고, 계획 산출물에서 자동 생성된 본문으로 PR을 작성하며, 선택적으로 검토를 요청하고 STATE.md에 추적합니다.
@@ -312,7 +312,7 @@
### 7. UI Review
**명령어:** `/gsd:ui-review [N]`
**명령어:** `/gsd-ui-review [N]`
**목적:** 구현된 프론트엔드 코드의 소급 6기둥 시각적 감사. 모든 프로젝트에서 독립적으로 작동합니다.
@@ -337,7 +337,7 @@
### 8. Milestone Management
**명령어:** `/gsd:audit-milestone`, `/gsd:complete-milestone`, `/gsd:new-milestone [name]`
**명령어:** `/gsd-audit-milestone`, `/gsd-complete-milestone`, `/gsd-new-milestone [name]`
**목적:** 마일스톤 완료를 검증하고, 보관하고, 릴리스 태그를 지정하며, 다음 개발 주기를 시작합니다.
@@ -352,7 +352,7 @@
- REQ-MILE-08: 새 마일스톤은 new-project와 동일한 흐름을 따라야 합니다(질문 → 연구 → 요구사항 → 로드맵).
- REQ-MILE-09: 새 마일스톤은 기존 워크플로우 구성을 초기화해서는 안 됩니다.
**갭 해소.** `/gsd:plan-milestone-gaps`는 감사에서 식별된 갭을 해소하는 페이즈를 생성합니다.
**갭 해소.** `/gsd-plan-milestone-gaps`는 감사에서 식별된 갭을 해소하는 페이즈를 생성합니다.
---
@@ -360,7 +360,7 @@
### 9. Phase Management
**명령어:** `/gsd:add-phase`, `/gsd:insert-phase [N]`, `/gsd:remove-phase [N]`
**명령어:** `/gsd-add-phase`, `/gsd-insert-phase [N]`, `/gsd-remove-phase [N]`
**목적:** 개발 중 동적 로드맵 수정.
@@ -375,7 +375,7 @@
### 10. Quick Mode
**명령어:** `/gsd:quick [--full] [--discuss] [--research]`
**명령어:** `/gsd-quick [--full] [--discuss] [--research]`
**목적:** GSD 보증을 제공하지만 더 빠른 경로로 임시 작업을 실행합니다.
@@ -394,7 +394,7 @@
### 11. Autonomous Mode
**명령어:** `/gsd:autonomous [--from N]`
**명령어:** `/gsd-autonomous [--from N]`
**목적:** 나머지 모든 페이즈를 자율적으로 실행합니다 — 페이즈별로 논의 → 계획 → 실행.
@@ -409,7 +409,7 @@
### 12. Freeform Routing
**명령어:** `/gsd:do`
**명령어:** `/gsd-do`
**목적:** 자유형 텍스트를 분석하고 적절한 GSD 명령어로 라우팅합니다.
@@ -423,7 +423,7 @@
### 13. Note Capture
**명령어:** `/gsd:note`
**명령어:** `/gsd-note`
**목적:** 워크플로우를 방해하지 않고 아이디어를 즉시 캡처합니다. 타임스탬프가 있는 노트를 추가하거나, 모든 노트를 나열하거나, 노트를 구조화된 할 일로 승격합니다.
@@ -438,7 +438,7 @@
### 14. Auto-Advance (Next)
**명령어:** `/gsd:next`
**명령어:** `/gsd-next`
**목적:** 현재 프로젝트 상태를 자동으로 감지하고 다음 논리적 워크플로우 단계로 진행합니다. 현재 어느 페이즈/단계에 있는지 기억할 필요가 없습니다.
@@ -446,18 +446,18 @@
- REQ-NEXT-01: STATE.md, ROADMAP.md, 페이즈 디렉토리를 읽어 현재 위치를 확인해야 합니다.
- REQ-NEXT-02: 논의, 계획, 실행, 검증 중 어느 것이 필요한지 감지해야 합니다.
- REQ-NEXT-03: 올바른 명령어를 자동으로 호출해야 합니다.
- REQ-NEXT-04: 프로젝트가 없으면 `/gsd:new-project`를 제안해야 합니다.
- REQ-NEXT-05: 모든 페이즈가 완료되면 `/gsd:complete-milestone`을 제안해야 합니다.
- REQ-NEXT-04: 프로젝트가 없으면 `/gsd-new-project`를 제안해야 합니다.
- REQ-NEXT-05: 모든 페이즈가 완료되면 `/gsd-complete-milestone`을 제안해야 합니다.
**상태 감지 로직.**
| 상태 | 액션 |
|-------|--------|
| `.planning/` 디렉토리 없음 | `/gsd:new-project` 제안 |
| 페이즈에 CONTEXT.md 없음 | `/gsd:discuss-phase` 실행 |
| 페이즈에 PLAN.md 파일 없음 | `/gsd:plan-phase` 실행 |
| 계획 있지만 SUMMARY.md 없음 | `/gsd:execute-phase` 실행 |
| 실행되었지만 VERIFICATION.md 없음 | `/gsd:verify-work` 실행 |
| 모든 페이즈 완료 | `/gsd:complete-milestone` 제안 |
| `.planning/` 디렉토리 없음 | `/gsd-new-project` 제안 |
| 페이즈에 CONTEXT.md 없음 | `/gsd-discuss-phase` 실행 |
| 페이즈에 PLAN.md 파일 없음 | `/gsd-plan-phase` 실행 |
| 계획 있지만 SUMMARY.md 없음 | `/gsd-execute-phase` 실행 |
| 실행되었지만 VERIFICATION.md 없음 | `/gsd-verify-work` 실행 |
| 모든 페이즈 완료 | `/gsd-complete-milestone` 제안 |
---
@@ -472,12 +472,12 @@
- REQ-NYQ-02: 각 요구사항을 특정 테스트 명령어에 매핑해야 합니다.
- REQ-NYQ-03: 웨이브 0 작업(구현 전에 필요한 테스트 스캐폴딩)을 식별해야 합니다.
- REQ-NYQ-04: 계획 검사기는 Nyquist 준수를 8번째 검증 차원으로 적용해야 합니다.
- REQ-NYQ-05: `/gsd:validate-phase`를 통한 소급 유효성 검사를 지원해야 합니다.
- REQ-NYQ-05: `/gsd-validate-phase`를 통한 소급 유효성 검사를 지원해야 합니다.
- REQ-NYQ-06: `workflow.nyquist_validation: false`로 비활성화 가능해야 합니다.
**생성 산출물.** `{phase}-VALIDATION.md` — 테스트 커버리지 계약
**소급 유효성 검사(`/gsd:validate-phase [N]`).**
**소급 유효성 검사(`/gsd-validate-phase [N]`).**
- 구현을 스캔하고 요구사항을 테스트에 매핑합니다.
- 요구사항에 자동화된 검증이 없는 갭을 식별합니다.
- 테스트 생성을 위한 감사자를 생성합니다(최대 3회 시도).
@@ -505,7 +505,7 @@
**요구사항.**
- REQ-POSTVER-01: 작업 완료가 아닌 페이즈 목표에 대해 확인해야 합니다.
- REQ-POSTVER-02: 합격/불합격 분석이 담긴 VERIFICATION.md를 생성해야 합니다.
- REQ-POSTVER-03: `/gsd:verify-work`가 처리할 문제를 기록해야 합니다.
- REQ-POSTVER-03: `/gsd-verify-work`가 처리할 문제를 기록해야 합니다.
- REQ-POSTVER-04: `workflow.verifier: false`로 비활성화 가능해야 합니다.
---
@@ -526,7 +526,7 @@
### 19. Health Validation
**명령어:** `/gsd:health [--repair]`
**명령어:** `/gsd-health [--repair]`
**목적:** `.planning/` 디렉토리 무결성을 검증하고 문제를 자동으로 복구합니다.
@@ -549,7 +549,7 @@
- REQ-REGR-03: 회귀는 실행 후 검증 전에 표시되어야 합니다.
- REQ-REGR-04: 어느 이전 페이즈의 테스트가 실패했는지 식별해야 합니다.
**실행 시점.** `/gsd:execute-phase` 중 검증자 단계 전에 자동으로 실행됩니다.
**실행 시점.** `/gsd-execute-phase` 중 검증자 단계 전에 자동으로 실행됩니다.
---
@@ -563,7 +563,7 @@
- REQ-COVGATE-03: 포함되지 않은 요구사항은 계획 완료를 차단해야 합니다.
- REQ-COVGATE-04: 계획 커버리지가 없는 특정 요구사항을 보고해야 합니다.
**실행 시점.** `/gsd:plan-phase`의 계획 검사기 루프 후 자동으로 실행됩니다.
**실행 시점.** `/gsd-plan-phase`의 계획 검사기 루프 후 자동으로 실행됩니다.
---
@@ -591,7 +591,7 @@
### 23. Session Management
**명령어:** `/gsd:pause-work`, `/gsd:resume-work`, `/gsd:progress`
**명령어:** `/gsd-pause-work`, `/gsd-resume-work`, `/gsd-progress`
**목적:** 컨텍스트 초기화와 세션 간에 프로젝트 연속성을 유지합니다.
@@ -608,7 +608,7 @@
### 24. Session Reporting
**명령어:** `/gsd:session-report`
**명령어:** `/gsd-session-report`
**목적:** 수행된 작업, 달성된 결과, 예상 리소스 사용량을 캡처하는 구조화된 세션 후 요약 문서를 생성합니다.
@@ -647,7 +647,7 @@
### 26. Model Profiles
**명령어:** `/gsd:set-profile <quality|balanced|budget|inherit>`
**명령어:** `/gsd-set-profile <quality|balanced|budget|inherit>`
**목적:** 각 에이전트가 사용하는 AI 모델을 제어하여 품질과 비용의 균형을 맞춥니다.
@@ -683,7 +683,7 @@
### 27. Codebase Mapping
**명령어:** `/gsd:map-codebase [area]`
**명령어:** `/gsd-map-codebase [area]`
**목적:** 새 프로젝트를 시작하기 전에 기존 코드베이스를 분석하여 GSD가 무엇이 존재하는지 이해하도록 합니다.
@@ -691,7 +691,7 @@
- REQ-MAP-01: 각 분석 영역에 대한 병렬 매퍼 에이전트를 생성해야 합니다.
- REQ-MAP-02: `.planning/codebase/`에 구조화된 문서를 생성해야 합니다.
- REQ-MAP-03: 기술 스택, 아키텍처 패턴, 코딩 규범, 문제점을 감지해야 합니다.
- REQ-MAP-04: 이후 `/gsd:new-project`는 코드베이스 매핑을 로드하고 추가하는 내용에 대한 질문에 집중해야 합니다.
- REQ-MAP-04: 이후 `/gsd-new-project`는 코드베이스 매핑을 로드하고 추가하는 내용에 대한 질문에 집중해야 합니다.
- REQ-MAP-05: 선택적 `[area]` 인수는 매핑 범위를 특정 영역으로 제한해야 합니다.
**생성 산출물.**
@@ -711,7 +711,7 @@
### 28. Debug System
**명령어:** `/gsd:debug [description]`
**명령어:** `/gsd-debug [description]`
**목적:** 컨텍스트 초기화 전반에 걸쳐 영구적인 상태로 체계적인 디버깅을 수행합니다.
@@ -729,7 +729,7 @@
### 29. Todo Management
**명령어:** `/gsd:add-todo [desc]`, `/gsd:check-todos`
**명령어:** `/gsd-add-todo [desc]`, `/gsd-check-todos`
**목적:** 세션 중 나중에 처리할 아이디어와 작업을 캡처합니다.
@@ -743,7 +743,7 @@
### 30. Statistics Dashboard
**명령어:** `/gsd:stats`
**명령어:** `/gsd-stats`
**목적:** 프로젝트 지표를 표시합니다 — 페이즈, 계획, 요구사항, git 히스토리, 타임라인.
@@ -757,7 +757,7 @@
### 31. Update System
**명령어:** `/gsd:update`
**명령어:** `/gsd-update`
**목적:** 변경 로그 미리보기와 함께 GSD를 최신 버전으로 업데이트합니다.
@@ -766,13 +766,13 @@
- REQ-UPDATE-02: 업데이트 전에 새 버전의 변경 로그를 표시해야 합니다.
- REQ-UPDATE-03: 런타임을 인식하고 올바른 디렉토리를 대상으로 해야 합니다.
- REQ-UPDATE-04: 로컬에서 수정된 파일을 `gsd-local-patches/`에 백업해야 합니다.
- REQ-UPDATE-05: `/gsd:reapply-patches`는 업데이트 후 로컬 수정사항을 복원해야 합니다.
- REQ-UPDATE-05: `/gsd-reapply-patches`는 업데이트 후 로컬 수정사항을 복원해야 합니다.
---
### 32. Settings Management
**명령어:** `/gsd:settings`
**명령어:** `/gsd-settings`
**목적:** 워크플로우 토글과 모델 프로파일의 대화형 구성.
@@ -805,7 +805,7 @@
### 33. Test Generation
**명령어:** `/gsd:add-tests [N]`
**명령어:** `/gsd-add-tests [N]`
**목적:** UAT 기준과 구현을 기반으로 완료된 페이즈에 대한 테스트를 생성합니다.
@@ -897,14 +897,14 @@ fix(03-01): correct auth token expiry
**상태표시줄 표시.**
```
[⬆ /gsd:update │] model │ [current task │] directory [█████░░░░░ 50%]
[⬆ /gsd-update │] model │ [current task │] directory [█████░░░░░ 50%]
```
색상 코드: <50% 초록, <65% 노랑, <80% 주황, ≥80% 해골 이모지와 함께 빨강
### 38. Developer Profiling
**명령어:** `/gsd:profile-user [--questionnaire] [--refresh]`
**명령어:** `/gsd-profile-user [--questionnaire] [--refresh]`
**목적:** Claude Code 세션 히스토리를 분석하여 8가지 차원에서 행동 프로파일을 구축하고, 개발자의 스타일에 맞게 Claude 응답을 개인화하는 산출물을 생성합니다.
@@ -920,7 +920,7 @@ fix(03-01): correct auth token expiry
**생성 산출물.**
- `USER-PROFILE.md` — 증거 인용이 포함된 전체 행동 프로파일
- `/gsd:dev-preferences` 명령어 — 모든 세션에서 선호도 로드
- `/gsd-dev-preferences` 명령어 — 모든 세션에서 선호도 로드
- `CLAUDE.md` 프로파일 섹션 — Claude Code가 자동으로 검색
**플래그.**
@@ -962,14 +962,14 @@ fix(03-01): correct auth token expiry
### 40. Verification Debt Tracking
**명령어:** `/gsd:audit-uat`
**명령어:** `/gsd-audit-uat`
**목적:** 프로젝트가 미결 테스트가 있는 페이즈를 넘어 진행할 때 UAT/검증 항목이 자동으로 누락되는 것을 방지합니다. 모든 이전 페이즈에 걸쳐 검증 부채를 표시하여 항목이 잊히지 않도록 합니다.
**구성 요소.**
**1. 교차 페이즈 상태 확인** (progress.md 1.6단계)
모든 `/gsd:progress` 호출은 현재 마일스톤의 모든 페이즈에서 미결 항목(pending, skipped, blocked, human_needed)을 스캔합니다. 실행 가능한 링크가 포함된 비차단 경고 섹션을 표시합니다.
모든 `/gsd-progress` 호출은 현재 마일스톤의 모든 페이즈에서 미결 항목(pending, skipped, blocked, human_needed)을 스캔합니다. 실행 가능한 링크가 포함된 비차단 경고 섹션을 표시합니다.
**2. `status: partial`** (verify-work.md, UAT.md)
"세션 종료"와 "모든 테스트 해결" 사이를 구분하는 새 UAT 상태입니다. 테스트가 여전히 pending, blocked, 또는 이유 없이 skipped된 경우 `status: complete`를 방지합니다.
@@ -984,12 +984,12 @@ fix(03-01): correct auth token expiry
`phase complete` CLI는 JSON 출력에 검증 부채 경고를 반환합니다. 전환 워크플로우는 확인 전에 미결 항목을 표시합니다.
**요구사항.**
- REQ-DEBT-01: `/gsd:progress`에서 모든 이전 페이즈의 미결 UAT/검증 항목을 표시해야 합니다.
- REQ-DEBT-01: `/gsd-progress`에서 모든 이전 페이즈의 미결 UAT/검증 항목을 표시해야 합니다.
- REQ-DEBT-02: 불완전한 테스트(partial)와 완료된 테스트(complete)를 구분해야 합니다.
- REQ-DEBT-03: 차단된 테스트를 `blocked_by` 태그로 분류해야 합니다.
- REQ-DEBT-04: human_needed 검증 항목을 추적 가능한 UAT 파일로 저장해야 합니다.
- REQ-DEBT-05: 검증 부채가 있을 때 페이즈 완료와 전환 중에 경고해야 합니다(비차단).
- REQ-DEBT-06: `/gsd:audit-uat`는 모든 페이즈를 스캔하고 테스트 가능성별로 항목을 분류하며 사람 테스트 계획을 생성해야 합니다.
- REQ-DEBT-06: `/gsd-audit-uat`는 모든 페이즈를 스캔하고 테스트 가능성별로 항목을 분류하며 사람 테스트 계획을 생성해야 합니다.
---
@@ -997,7 +997,7 @@ fix(03-01): correct auth token expiry
### 41. Fast Mode
**명령어:** `/gsd:fast [task description]`
**명령어:** `/gsd-fast [task description]`
**목적:** 하위 에이전트를 생성하거나 PLAN.md 파일을 생성하지 않고 인라인으로 간단한 작업을 실행합니다. 계획 오버헤드를 정당화하기에는 너무 작은 작업에 사용합니다: 오타 수정, 구성 변경, 작은 리팩터링, 잊혀진 커밋, 간단한 추가.
@@ -1007,15 +1007,15 @@ fix(03-01): correct auth token expiry
- REQ-FAST-03: 상태 일관성을 위해 `.planning/quick/`에 작업을 추적해야 합니다.
- REQ-FAST-04: 연구, 다단계 계획, 또는 검증이 필요한 작업에는 사용해서는 안 됩니다.
**`/gsd:quick`과 비교하여 사용 시점.**
- `/gsd:fast` — 2분 이내에 실행 가능한 한 문장 작업(오타, 구성 변경, 작은 추가)
- `/gsd:quick` — 연구, 다단계 계획, 또는 검증이 필요한 모든 것
**`/gsd-quick`과 비교하여 사용 시점.**
- `/gsd-fast` — 2분 이내에 실행 가능한 한 문장 작업(오타, 구성 변경, 작은 추가)
- `/gsd-quick` — 연구, 다단계 계획, 또는 검증이 필요한 모든 것
---
### 42. Cross-AI Peer Review
**명령어:** `/gsd:review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
**명령어:** `/gsd-review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
**목적:** 외부 AI CLI(Gemini, Claude, Codex, CodeRabbit)를 호출하여 페이즈 계획을 독립적으로 검토합니다. 검토자별 피드백이 담긴 구조화된 REVIEWS.md를 생성합니다.
@@ -1024,7 +1024,7 @@ fix(03-01): correct auth token expiry
- REQ-REVIEW-02: 페이즈 계획에서 구조화된 검토 프롬프트를 작성해야 합니다.
- REQ-REVIEW-03: 선택된 각 CLI를 독립적으로 호출해야 합니다.
- REQ-REVIEW-04: 응답을 수집하고 `REVIEWS.md`를 생성해야 합니다.
- REQ-REVIEW-05: 검토는 `/gsd:plan-phase --reviews`가 사용할 수 있어야 합니다.
- REQ-REVIEW-05: 검토는 `/gsd-plan-phase --reviews`가 사용할 수 있어야 합니다.
**생성 산출물.** `{phase}-REVIEWS.md` — 검토자별 구조화된 피드백
@@ -1032,17 +1032,17 @@ fix(03-01): correct auth token expiry
### 43. Backlog Parking Lot
**명령어:** `/gsd:add-backlog <description>`, `/gsd:review-backlog`, `/gsd:plant-seed <idea>`
**명령어:** `/gsd-add-backlog <description>`, `/gsd-review-backlog`, `/gsd-plant-seed <idea>`
**목적:** 아직 적극적인 계획에 준비되지 않은 아이디어를 캡처합니다. 백로그 항목은 활성 페이즈 순서 밖에 있기 위해 999.x 번호를 사용합니다. 시드는 올바른 마일스톤에서 자동으로 표시되는 트리거 조건이 있는 미래 지향적 아이디어입니다.
**요구사항.**
- REQ-BACKLOG-01: 백로그 항목은 활성 페이즈 순서 밖에 있기 위해 999.x 번호를 사용해야 합니다.
- REQ-BACKLOG-02: `/gsd:discuss-phase`와 `/gsd:plan-phase`가 작동할 수 있도록 페이즈 디렉토리를 즉시 생성해야 합니다.
- REQ-BACKLOG-03: `/gsd:review-backlog`는 항목별로 승격, 유지, 제거 액션을 지원해야 합니다.
- REQ-BACKLOG-02: `/gsd-discuss-phase`와 `/gsd-plan-phase`가 작동할 수 있도록 페이즈 디렉토리를 즉시 생성해야 합니다.
- REQ-BACKLOG-03: `/gsd-review-backlog`는 항목별로 승격, 유지, 제거 액션을 지원해야 합니다.
- REQ-BACKLOG-04: 승격된 항목은 활성 마일스톤 순서로 번호가 다시 매겨져야 합니다.
- REQ-SEED-01: 시드는 표시 조건에 대한 전체 이유와 시기를 캡처해야 합니다.
- REQ-SEED-02: `/gsd:new-milestone`은 시드를 스캔하고 일치하는 항목을 표시해야 합니다.
- REQ-SEED-02: `/gsd-new-milestone`은 시드를 스캔하고 일치하는 항목을 표시해야 합니다.
**생성 산출물.**
| 산출물 | 설명 |
@@ -1054,9 +1054,9 @@ fix(03-01): correct auth token expiry
### 44. Persistent Context Threads
**명령어:** `/gsd:thread [name | description]`
**명령어:** `/gsd-thread [name | description]`
**목적:** 여러 세션에 걸쳐 있지만 특정 페이즈에 속하지 않는 작업을 위한 가벼운 교차 세션 지식 저장소입니다. `/gsd:pause-work`보다 더 가볍습니다 — 페이즈 상태나 계획 컨텍스트가 없습니다.
**목적:** 여러 세션에 걸쳐 있지만 특정 페이즈에 속하지 않는 작업을 위한 가벼운 교차 세션 지식 저장소입니다. `/gsd-pause-work`보다 더 가볍습니다 — 페이즈 상태나 계획 컨텍스트가 없습니다.
**요구사항.**
- REQ-THREAD-01: 생성, 나열, 재개 모드를 지원해야 합니다.
@@ -1071,7 +1071,7 @@ fix(03-01): correct auth token expiry
### 45. PR Branch Filtering
**명령어:** `/gsd:pr-branch [target branch]`
**명령어:** `/gsd-pr-branch [target branch]`
**목적:** `.planning/` 커밋을 필터링하여 풀 리퀘스트에 적합한 깔끔한 브랜치를 생성합니다. 검토자는 GSD 계획 산출물이 아닌 코드 변경사항만 봅니다.
@@ -1099,7 +1099,7 @@ fix(03-01): correct auth token expiry
`.planning/`을 대상으로 하는 Write/Edit 호출에서 주입 패턴을 스캔하는 PreToolUse 훅입니다. 정당한 작업을 차단하지 않고 인식을 위해 감지를 기록하는 권고 전용입니다.
**3. 워크플로우 가드 훅** (`gsd-workflow-guard.js`)
Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하는 것을 감지하는 PreToolUse 훅입니다. 직접 편집 대신 `/gsd:quick` 또는 `/gsd:fast` 사용을 권고합니다. `hooks.workflow_guard`로 구성 가능합니다(기본값: false).
Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하는 것을 감지하는 PreToolUse 훅입니다. 직접 편집 대신 `/gsd-quick` 또는 `/gsd-fast` 사용을 권고합니다. `hooks.workflow_guard`로 구성 가능합니다(기본값: false).
**4. CI 준비 주입 스캐너** (`prompt-injection-scan.test.cjs`)
모든 에이전트, 워크플로우, 명령어 파일에서 포함된 주입 벡터를 스캔하는 테스트 스위트입니다.
@@ -1126,7 +1126,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 48. Discussion Audit Trail
**목적:** `/gsd:discuss-phase` 중에 `DISCUSSION-LOG.md`를 자동 생성하여 논의 중에 내려진 결정의 전체 감사 추적을 제공합니다.
**목적:** `/gsd-discuss-phase` 중에 `DISCUSSION-LOG.md`를 자동 생성하여 논의 중에 내려진 결정의 전체 감사 추적을 제공합니다.
**요구사항.**
- REQ-DISCLOG-01: discuss-phase 중에 DISCUSSION-LOG.md를 자동 생성해야 합니다.
@@ -1139,7 +1139,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 49. Forensics
**명령어:** `/gsd:forensics [description]`
**명령어:** `/gsd-forensics [description]`
**목적:** 실패하거나 막힌 GSD 워크플로우의 사후 조사.
@@ -1165,7 +1165,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 50. Milestone Summary
**명령어:** `/gsd:milestone-summary [version]`
**명령어:** `/gsd-milestone-summary [version]`
**목적:** 팀 온보딩을 위해 마일스톤 산출물에서 포괄적인 프로젝트 요약을 생성합니다.
@@ -1188,7 +1188,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 51. Workstream Namespacing
**명령어:** `/gsd:workstreams`
**명령어:** `/gsd-workstreams`
**목적:** 마일스톤의 다른 영역에서 동시 작업을 위한 병렬 워크스트림.
@@ -1211,7 +1211,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 52. Manager Dashboard
**명령어:** `/gsd:manager`
**명령어:** `/gsd-manager`
**목적:** 하나의 터미널에서 여러 페이즈를 관리하는 대화형 명령 센터.
@@ -1231,7 +1231,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 53. Assumptions Discussion Mode
**명령어:** `/gsd:discuss-phase` with `workflow.discuss_mode: 'assumptions'`
**명령어:** `/gsd-discuss-phase` with `workflow.discuss_mode: 'assumptions'`
**목적:** 인터뷰 스타일 질문을 코드베이스 우선 가정 분석으로 대체합니다.
@@ -1257,20 +1257,20 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
### 54. UI Phase Auto-Detection
**일부:** `/gsd:new-project` 및 `/gsd:progress`
**일부:** `/gsd-new-project` 및 `/gsd-progress`
**목적:** UI 중심 프로젝트를 자동으로 감지하고 `/gsd:ui-phase` 권장사항을 표시합니다.
**목적:** UI 중심 프로젝트를 자동으로 감지하고 `/gsd-ui-phase` 권장사항을 표시합니다.
**요구사항.**
- REQ-UI-DETECT-01: 프로젝트 설명에서 UI 신호를 감지해야 합니다(키워드, 프레임워크 참조).
- REQ-UI-DETECT-02: 해당하는 경우 ROADMAP.md 페이즈에 `ui_hint`를 주석으로 추가해야 합니다.
- REQ-UI-DETECT-03: UI 중심 페이즈의 다음 단계에서 `/gsd:ui-phase`를 제안해야 합니다.
- REQ-UI-DETECT-04: `/gsd:ui-phase`를 필수로 만들어서는 안 됩니다.
- REQ-UI-DETECT-03: UI 중심 페이즈의 다음 단계에서 `/gsd-ui-phase`를 제안해야 합니다.
- REQ-UI-DETECT-04: `/gsd-ui-phase`를 필수로 만들어서는 안 됩니다.
**프로세스.**
1. **감지** — UI 신호(키워드, 프레임워크 참조)에 대한 프로젝트 설명 및 기술 스택 스캔
2. **주석** — ROADMAP.md의 해당 페이즈에 `ui_hint` 표시 추가
3. **표시** — UI 중심 페이즈의 다음 단계에 `/gsd:ui-phase` 권장사항 포함
3. **표시** — UI 중심 페이즈의 다음 단계에 `/gsd-ui-phase` 권장사항 포함
---

View File

@@ -21,7 +21,7 @@ Get Shit Done (GSD) 프레임워크의 종합 문서입니다. GSD는 AI 코딩
## 빠른 링크
- **v1.28의 새로운 기능:** Forensics, milestone 요약, workstream, assumptions 모드, UI 자동 감지, manager 대시보드
- **시작하기:** [README](../README.md) → 설치 → `/gsd:new-project`
- **시작하기:** [README](../README.md) → 설치 → `/gsd-new-project`
- **전체 워크플로우 안내:** [User Guide](USER-GUIDE.md)
- **모든 명령어 한눈에 보기:** [Command Reference](COMMANDS.md)
- **GSD 설정하기:** [Configuration Reference](CONFIGURATION.md)

View File

@@ -26,7 +26,7 @@
```
┌──────────────────────────────────────────────────┐
│ NEW PROJECT │
│ /gsd:new-project │
│ /gsd-new-project │
│ Questions -> Research -> Requirements -> Roadmap│
└─────────────────────────┬────────────────────────┘
│
@@ -34,27 +34,27 @@
│ FOR EACH PHASE: │
│ │
│ ┌────────────────────┐ │
│ │ /gsd:discuss-phase │ │ <- Lock in preferences
│ │ /gsd-discuss-phase │ │ <- Lock in preferences
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:ui-phase │ │ <- Design contract (frontend)
│ │ /gsd-ui-phase │ │ <- Design contract (frontend)
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:plan-phase │ │ <- Research + Plan + Verify
│ │ /gsd-plan-phase │ │ <- Research + Plan + Verify
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:execute-phase │ │ <- Parallel execution
│ │ /gsd-execute-phase │ │ <- Parallel execution
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:verify-work │ │ <- Manual UAT
│ │ /gsd-verify-work │ │ <- Manual UAT
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:ship │ │ <- Create PR (optional)
│ │ /gsd-ship │ │ <- Create PR (optional)
│ └──────────┬─────────┘ │
│ │ │
│ Next Phase?────────────┘
@@ -62,8 +62,8 @@
└─────────────┼──────────────┘
│
┌───────────────▼──────────────┐
│ /gsd:audit-milestone │
│ /gsd:complete-milestone │
│ /gsd-audit-milestone │
│ /gsd-complete-milestone │
└───────────────┬──────────────┘
│
Another milestone?
@@ -71,14 +71,14 @@
Yes No -> Done!
│
┌───────▼──────────────┐
│ /gsd:new-milestone │
│ /gsd-new-milestone │
└──────────────────────┘
```
### 계획 에이전트 조정
```
/gsd:plan-phase N
/gsd-plan-phase N
│
├── Phase Researcher (x4 parallel)
│ ├── Stack researcher
@@ -119,14 +119,14 @@ plan-phase 조사 단계에서 GSD는 코드 작성 전에 각 페이즈 요구
**출력:** `{phase}-VALIDATION.md` — 해당 페이즈의 피드백 계약.
**비활성화:** 테스트 인프라가 중요하지 않은 빠른 프로토타이핑 페이즈에서는 `/gsd:settings`에서 `workflow.nyquist_validation: false`로 설정하세요.
**비활성화:** 테스트 인프라가 중요하지 않은 빠른 프로토타이핑 페이즈에서는 `/gsd-settings`에서 `workflow.nyquist_validation: false`로 설정하세요.
### 소급 검증 (`/gsd:validate-phase`)
### 소급 검증 (`/gsd-validate-phase`)
Nyquist 검증 도입 전에 실행된 페이즈나 전통적인 테스트 스위트만 있는 기존 코드베이스의 경우 커버리지 갭을 소급하여 감사하고 보완할 수 있습니다.
```
/gsd:validate-phase N
/gsd-validate-phase N
|
+-- Detect state (VALIDATION.md exists? SUMMARY.md exists?)
|
@@ -146,13 +146,13 @@ Nyquist 검증 도입 전에 실행된 페이즈나 전통적인 테스트 스
감사자는 구현 코드를 수정하지 않으며 테스트 파일과 VALIDATION.md만 수정합니다. 테스트에서 구현 버그가 발견되면 사용자가 처리할 수 있도록 에스컬레이션으로 표시됩니다.
**사용 시점:** Nyquist가 활성화되기 전에 계획된 페이즈를 실행한 후 또는 `/gsd:audit-milestone`에서 Nyquist 준수 갭이 발견된 후에 사용합니다.
**사용 시점:** Nyquist가 활성화되기 전에 계획된 페이즈를 실행한 후 또는 `/gsd-audit-milestone`에서 Nyquist 준수 갭이 발견된 후에 사용합니다.
### 가정 토론 모드
기본적으로 `/gsd:discuss-phase`는 구현 선호도에 대한 개방형 질문을 합니다. 가정 모드는 이를 역전시킵니다. GSD가 먼저 코드베이스를 읽고 페이즈를 어떻게 구축할지에 대한 구조화된 가정을 제시한 후 수정사항만 요청합니다.
기본적으로 `/gsd-discuss-phase`는 구현 선호도에 대한 개방형 질문을 합니다. 가정 모드는 이를 역전시킵니다. GSD가 먼저 코드베이스를 읽고 페이즈를 어떻게 구축할지에 대한 구조화된 가정을 제시한 후 수정사항만 요청합니다.
**활성화:** `/gsd:settings`에서 `workflow.discuss_mode`를 `'assumptions'`로 설정합니다.
**활성화:** `/gsd-settings`에서 `workflow.discuss_mode`를 `'assumptions'`로 설정합니다.
**작동 방식.**
1. PROJECT.md, 코드베이스 매핑, 기존 관례를 읽습니다.
@@ -175,18 +175,18 @@ Nyquist 검증 도입 전에 실행된 페이즈나 전통적인 테스트 스
AI 생성 프론트엔드가 시각적으로 일관성이 없는 이유는 Claude Code의 UI 능력이 부족해서가 아닙니다. 실행 전에 설계 계약이 존재하지 않았기 때문입니다. 공유 간격 척도, 색상 계약, 또는 카피라이팅 기준 없이 구축된 다섯 개의 컴포넌트는 다섯 가지 약간씩 다른 시각적 결정을 만들어냅니다.
`/gsd:ui-phase`는 계획 전에 설계 계약을 확정합니다. `/gsd:ui-review`는 실행 후 결과를 감사합니다.
`/gsd-ui-phase`는 계획 전에 설계 계약을 확정합니다. `/gsd-ui-review`는 실행 후 결과를 감사합니다.
### 명령어
| 명령어 | 설명 |
|--------|------|
| `/gsd:ui-phase [N]` | 프론트엔드 페이즈를 위한 UI-SPEC.md 설계 계약 생성 |
| `/gsd:ui-review [N]` | 구현된 UI의 6개 기둥 기반 시각적 감사 소급 수행 |
| `/gsd-ui-phase [N]` | 프론트엔드 페이즈를 위한 UI-SPEC.md 설계 계약 생성 |
| `/gsd-ui-review [N]` | 구현된 UI의 6개 기둥 기반 시각적 감사 소급 수행 |
### 워크플로우: `/gsd:ui-phase`
### 워크플로우: `/gsd-ui-phase`
**실행 시점:** `/gsd:discuss-phase` 이후, `/gsd:plan-phase` 이전 — 프론트엔드/UI 작업이 포함된 페이즈.
**실행 시점:** `/gsd-discuss-phase` 이후, `/gsd-plan-phase` 이전 — 프론트엔드/UI 작업이 포함된 페이즈.
**흐름.**
1. CONTEXT.md, RESEARCH.md, REQUIREMENTS.md에서 기존 결정사항을 읽습니다.
@@ -199,9 +199,9 @@ AI 생성 프론트엔드가 시각적으로 일관성이 없는 이유는 Claud
**출력:** `.planning/phases/{phase-dir}/`의 `{padded_phase}-UI-SPEC.md`
### 워크플로우: `/gsd:ui-review`
### 워크플로우: `/gsd-ui-review`
**실행 시점:** `/gsd:execute-phase` 또는 `/gsd:verify-work` 이후 — 프론트엔드 코드가 있는 모든 프로젝트.
**실행 시점:** `/gsd-execute-phase` 또는 `/gsd-verify-work` 이후 — 프론트엔드 코드가 있는 모든 프로젝트.
**독립 실행:** 모든 프로젝트에서 작동하며 GSD 관리 프로젝트가 아니어도 됩니다. UI-SPEC.md가 없으면 추상적인 6개 기둥 기준으로 감사합니다.
@@ -220,9 +220,9 @@ AI 생성 프론트엔드가 시각적으로 일관성이 없는 이유는 Claud
| 설정 | 기본값 | 설명 |
|------|--------|------|
| `workflow.ui_phase` | `true` | 프론트엔드 페이즈를 위한 UI 설계 계약 생성 |
| `workflow.ui_safety_gate` | `true` | plan-phase가 프론트엔드 페이즈에서 /gsd:ui-phase 실행을 유도합니다 |
| `workflow.ui_safety_gate` | `true` | plan-phase가 프론트엔드 페이즈에서 /gsd-ui-phase 실행을 유도합니다 |
두 설정 모두 부재 시 활성화 패턴을 따릅니다. `/gsd:settings`에서 비활성화할 수 있습니다.
두 설정 모두 부재 시 활성화 패턴을 따릅니다. `/gsd-settings`에서 비활성화할 수 있습니다.
### shadcn 초기화
@@ -245,7 +245,7 @@ React/Next.js/Vite 프로젝트에서 `components.json`이 없으면 UI 조사
### 스크린샷 저장
`/gsd:ui-review`는 Playwright CLI를 통해 `.planning/ui-reviews/`에 스크린샷을 캡처합니다. 바이너리 파일이 git에 포함되지 않도록 `.gitignore`가 자동으로 생성됩니다. 스크린샷은 `/gsd:complete-milestone` 실행 시 정리됩니다.
`/gsd-ui-review`는 Playwright CLI를 통해 `.planning/ui-reviews/`에 스크린샷을 캡처합니다. 바이너리 파일이 git에 포함되지 않도록 `.gitignore`가 자동으로 생성됩니다. 스크린샷은 `/gsd-complete-milestone` 실행 시 정리됩니다.
---
@@ -256,23 +256,23 @@ React/Next.js/Vite 프로젝트에서 `components.json`이 없으면 UI 조사
활성 계획에 아직 준비되지 않은 아이디어는 999.x 번호 체계를 사용하여 백로그에 보관하며 활성 페이즈 순서 밖에 유지됩니다.
```
/gsd:add-backlog "GraphQL API layer" # Creates 999.1-graphql-api-layer/
/gsd:add-backlog "Mobile responsive" # Creates 999.2-mobile-responsive/
/gsd-add-backlog "GraphQL API layer" # Creates 999.1-graphql-api-layer/
/gsd-add-backlog "Mobile responsive" # Creates 999.2-mobile-responsive/
```
백로그 항목은 전체 페이즈 디렉터리를 얻으므로 `/gsd:discuss-phase 999.1`로 아이디어를 더 탐구하거나 준비가 되면 `/gsd:plan-phase 999.1`을 사용할 수 있습니다.
백로그 항목은 전체 페이즈 디렉터리를 얻으므로 `/gsd-discuss-phase 999.1`로 아이디어를 더 탐구하거나 준비가 되면 `/gsd-plan-phase 999.1`을 사용할 수 있습니다.
`/gsd:review-backlog`으로 **검토 및 승격**합니다 — 모든 백로그 항목을 표시하고 승격 (활성 순서로 이동), 유지 (백로그에 남김), 또는 제거 (삭제)를 선택할 수 있습니다.
`/gsd-review-backlog`으로 **검토 및 승격**합니다 — 모든 백로그 항목을 표시하고 승격 (활성 순서로 이동), 유지 (백로그에 남김), 또는 제거 (삭제)를 선택할 수 있습니다.
### 시드
시드는 트리거 조건이 있는 미래 지향적인 아이디어입니다. 백로그 항목과 달리 시드는 적절한 마일스톤 시점에 자동으로 표면화됩니다.
```
/gsd:plant-seed "Add real-time collab when WebSocket infra is in place"
/gsd-plant-seed "Add real-time collab when WebSocket infra is in place"
```
시드는 전체 WHY와 언제 표면화할지를 보존합니다. `/gsd:new-milestone`은 모든 시드를 스캔하여 일치 항목을 제시합니다.
시드는 전체 WHY와 언제 표면화할지를 보존합니다. `/gsd-new-milestone`은 모든 시드를 스캔하여 일치 항목을 제시합니다.
**저장 위치:** `.planning/seeds/SEED-NNN-slug.md`
@@ -281,14 +281,14 @@ React/Next.js/Vite 프로젝트에서 `components.json`이 없으면 UI 조사
스레드는 여러 세션에 걸쳐 이어지지만 특정 페이즈에 속하지 않는 작업을 위한 경량 교차 세션 지식 저장소입니다.
```
/gsd:thread # List all threads
/gsd:thread fix-deploy-key-auth # Resume existing thread
/gsd:thread "Investigate TCP timeout" # Create new thread
/gsd-thread # List all threads
/gsd-thread fix-deploy-key-auth # Resume existing thread
/gsd-thread "Investigate TCP timeout" # Create new thread
```
스레드는 `/gsd:pause-work`보다 가볍습니다. 페이즈 상태나 계획 컨텍스트가 없습니다. 각 스레드 파일에는 목표, 컨텍스트, 참조, 다음 단계 섹션이 포함됩니다.
스레드는 `/gsd-pause-work`보다 가볍습니다. 페이즈 상태나 계획 컨텍스트가 없습니다. 각 스레드 파일에는 목표, 컨텍스트, 참조, 다음 단계 섹션이 포함됩니다.
스레드가 성숙해지면 페이즈(`/gsd:add-phase`)나 백로그 항목(`/gsd:add-backlog`)으로 승격할 수 있습니다.
스레드가 성숙해지면 페이즈(`/gsd-add-phase`)나 백로그 항목(`/gsd-add-backlog`)으로 승격할 수 있습니다.
**저장 위치:** `.planning/threads/{slug}.md`
@@ -304,16 +304,16 @@ React/Next.js/Vite 프로젝트에서 `components.json`이 없으면 UI 조사
| 명령어 | 목적 |
|--------|------|
| `/gsd:workstreams create <name>` | 격리된 계획 상태로 새 워크스트림 생성 |
| `/gsd:workstreams switch <name>` | 활성 컨텍스트를 다른 워크스트림으로 전환 |
| `/gsd:workstreams list` | 모든 워크스트림과 활성 워크스트림 표시 |
| `/gsd:workstreams complete <name>` | 워크스트림을 완료로 표시하고 상태 아카이브 |
| `/gsd-workstreams create <name>` | 격리된 계획 상태로 새 워크스트림 생성 |
| `/gsd-workstreams switch <name>` | 활성 컨텍스트를 다른 워크스트림으로 전환 |
| `/gsd-workstreams list` | 모든 워크스트림과 활성 워크스트림 표시 |
| `/gsd-workstreams complete <name>` | 워크스트림을 완료로 표시하고 상태 아카이브 |
### 작동 방식
각 워크스트림은 자체 `.planning/` 디렉터리 하위 트리를 유지합니다. 워크스트림을 전환하면 GSD가 활성 계획 컨텍스트를 교체하여 `/gsd:progress`, `/gsd:discuss-phase`, `/gsd:plan-phase` 및 기타 명령어가 해당 워크스트림의 상태로 동작합니다.
각 워크스트림은 자체 `.planning/` 디렉터리 하위 트리를 유지합니다. 워크스트림을 전환하면 GSD가 활성 계획 컨텍스트를 교체하여 `/gsd-progress`, `/gsd-discuss-phase`, `/gsd-plan-phase` 및 기타 명령어가 해당 워크스트림의 상태로 동작합니다.
이는 `/gsd:new-workspace`(별도 저장소 worktree를 생성)보다 가볍습니다. 워크스트림은 동일한 코드베이스와 git 히스토리를 공유하지만 계획 아티팩트를 격리합니다.
이는 `/gsd-new-workspace`(별도 저장소 worktree를 생성)보다 가볍습니다. 워크스트림은 동일한 코드베이스와 git 히스토리를 공유하지만 계획 아티팩트를 격리합니다.
---
@@ -341,7 +341,7 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니
### 실행 웨이브 조정
```
/gsd:execute-phase N
/gsd-execute-phase N
│
├── Analyze plan dependencies
│
@@ -356,13 +356,13 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니
└── Check codebase against phase goals
│
├── PASS -> VERIFICATION.md (success)
└── FAIL -> Issues logged for /gsd:verify-work
└── FAIL -> Issues logged for /gsd-verify-work
```
### 브라운필드 워크플로우 (기존 코드베이스)
```
/gsd:map-codebase
/gsd-map-codebase
│
├── Stack Mapper -> codebase/STACK.md
├── Arch Mapper -> codebase/ARCHITECTURE.md
@@ -370,7 +370,7 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니
└── Concern Mapper -> codebase/CONCERNS.md
│
┌───────▼──────────┐
│ /gsd:new-project │ <- Questions focus on what you're ADDING
│ /gsd-new-project │ <- Questions focus on what you're ADDING
└──────────────────┘
```
@@ -382,80 +382,80 @@ GSD는 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성합니
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:new-project` | 전체 프로젝트 초기화: 질문, 조사, 요구사항, 로드맵 | 새 프로젝트 시작 시 |
| `/gsd:new-project --auto @idea.md` | 문서에서 자동 초기화 | PRD나 아이디어 문서가 준비된 경우 |
| `/gsd:discuss-phase [N]` | 구현 결정사항 캡처 | 계획 전 구축 방식을 결정할 때 |
| `/gsd:ui-phase [N]` | UI 설계 계약 생성 | discuss-phase 이후, plan-phase 이전 (프론트엔드 페이즈) |
| `/gsd:plan-phase [N]` | 조사 + 계획 + 검증 | 페이즈 실행 전 |
| `/gsd:execute-phase <N>` | 병렬 웨이브로 모든 계획 실행 | 계획이 완료된 후 |
| `/gsd:verify-work [N]` | 자동 진단을 포함한 수동 UAT | 실행 완료 후 |
| `/gsd:ship [N]` | 검증된 작업으로 PR 생성 | 검증 통과 후 |
| `/gsd:fast <text>` | 계획을 완전히 건너뛰는 인라인 간단 작업 | 오타 수정, 설정 변경, 소규모 리팩터링 |
| `/gsd:next` | 상태 자동 감지 및 다음 단계 실행 | 언제든 — "다음에 무엇을 해야 하나?" |
| `/gsd:ui-review [N]` | 6개 기둥 기반 시각적 감사 소급 수행 | 실행 또는 verify-work 이후 (프론트엔드 프로젝트) |
| `/gsd:audit-milestone` | 마일스톤이 완료 정의를 충족했는지 검증 | 마일스톤 완료 전 |
| `/gsd:complete-milestone` | 마일스톤 아카이브 및 릴리스 태그 생성 | 모든 페이즈 검증 완료 시 |
| `/gsd:new-milestone [name]` | 다음 버전 사이클 시작 | 마일스톤 완료 후 |
| `/gsd-new-project` | 전체 프로젝트 초기화: 질문, 조사, 요구사항, 로드맵 | 새 프로젝트 시작 시 |
| `/gsd-new-project --auto @idea.md` | 문서에서 자동 초기화 | PRD나 아이디어 문서가 준비된 경우 |
| `/gsd-discuss-phase [N]` | 구현 결정사항 캡처 | 계획 전 구축 방식을 결정할 때 |
| `/gsd-ui-phase [N]` | UI 설계 계약 생성 | discuss-phase 이후, plan-phase 이전 (프론트엔드 페이즈) |
| `/gsd-plan-phase [N]` | 조사 + 계획 + 검증 | 페이즈 실행 전 |
| `/gsd-execute-phase <N>` | 병렬 웨이브로 모든 계획 실행 | 계획이 완료된 후 |
| `/gsd-verify-work [N]` | 자동 진단을 포함한 수동 UAT | 실행 완료 후 |
| `/gsd-ship [N]` | 검증된 작업으로 PR 생성 | 검증 통과 후 |
| `/gsd-fast <text>` | 계획을 완전히 건너뛰는 인라인 간단 작업 | 오타 수정, 설정 변경, 소규모 리팩터링 |
| `/gsd-next` | 상태 자동 감지 및 다음 단계 실행 | 언제든 — "다음에 무엇을 해야 하나?" |
| `/gsd-ui-review [N]` | 6개 기둥 기반 시각적 감사 소급 수행 | 실행 또는 verify-work 이후 (프론트엔드 프로젝트) |
| `/gsd-audit-milestone` | 마일스톤이 완료 정의를 충족했는지 검증 | 마일스톤 완료 전 |
| `/gsd-complete-milestone` | 마일스톤 아카이브 및 릴리스 태그 생성 | 모든 페이즈 검증 완료 시 |
| `/gsd-new-milestone [name]` | 다음 버전 사이클 시작 | 마일스톤 완료 후 |
### 탐색
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:progress` | 상태 및 다음 단계 표시 | 언제든 -- "지금 어디 있나?" |
| `/gsd:resume-work` | 마지막 세션의 전체 컨텍스트 복원 | 새 세션 시작 시 |
| `/gsd:pause-work` | 구조화된 핸드오프 저장 (HANDOFF.json + continue-here.md) | 페이즈 중간에 중단할 때 |
| `/gsd:session-report` | 작업 및 결과가 포함된 세션 요약 생성 | 세션 종료 시, 이해관계자 공유 시 |
| `/gsd:help` | 모든 명령어 표시 | 빠른 레퍼런스 |
| `/gsd:update` | 변경 로그 미리보기와 함께 GSD 업데이트 | 새 버전 확인 시 |
| `/gsd:join-discord` | Discord 커뮤니티 초대 링크 열기 | 질문이나 커뮤니티 참여 시 |
| `/gsd-progress` | 상태 및 다음 단계 표시 | 언제든 -- "지금 어디 있나?" |
| `/gsd-resume-work` | 마지막 세션의 전체 컨텍스트 복원 | 새 세션 시작 시 |
| `/gsd-pause-work` | 구조화된 핸드오프 저장 (HANDOFF.json + continue-here.md) | 페이즈 중간에 중단할 때 |
| `/gsd-session-report` | 작업 및 결과가 포함된 세션 요약 생성 | 세션 종료 시, 이해관계자 공유 시 |
| `/gsd-help` | 모든 명령어 표시 | 빠른 레퍼런스 |
| `/gsd-update` | 변경 로그 미리보기와 함께 GSD 업데이트 | 새 버전 확인 시 |
| `/gsd-join-discord` | Discord 커뮤니티 초대 링크 열기 | 질문이나 커뮤니티 참여 시 |
### 페이즈 관리
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:add-phase` | 로드맵에 새 페이즈 추가 | 초기 계획 후 범위가 늘어날 때 |
| `/gsd:insert-phase [N]` | 긴급 작업 삽입 (소수점 번호 체계) | 마일스톤 중간의 긴급 수정 시 |
| `/gsd:remove-phase [N]` | 미래 페이즈 제거 및 재번호 | 기능 범위 축소 시 |
| `/gsd:list-phase-assumptions [N]` | Claude의 예상 접근 방식 미리 확인 | 계획 전 방향 검증 시 |
| `/gsd:plan-milestone-gaps` | 감사 갭을 위한 페이즈 생성 | 감사에서 누락 항목이 발견된 후 |
| `/gsd:research-phase [N]` | 심층 에코시스템 조사만 수행 | 복잡하거나 익숙하지 않은 도메인 |
| `/gsd-add-phase` | 로드맵에 새 페이즈 추가 | 초기 계획 후 범위가 늘어날 때 |
| `/gsd-insert-phase [N]` | 긴급 작업 삽입 (소수점 번호 체계) | 마일스톤 중간의 긴급 수정 시 |
| `/gsd-remove-phase [N]` | 미래 페이즈 제거 및 재번호 | 기능 범위 축소 시 |
| `/gsd-list-phase-assumptions [N]` | Claude의 예상 접근 방식 미리 확인 | 계획 전 방향 검증 시 |
| `/gsd-plan-milestone-gaps` | 감사 갭을 위한 페이즈 생성 | 감사에서 누락 항목이 발견된 후 |
| `/gsd-research-phase [N]` | 심층 에코시스템 조사만 수행 | 복잡하거나 익숙하지 않은 도메인 |
### 브라운필드 및 유틸리티
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:map-codebase` | 기존 코드베이스 분석 | 기존 코드에서 `/gsd:new-project` 실행 전 |
| `/gsd:quick` | GSD 보증을 갖춘 임시 작업 | 버그 수정, 소규모 기능, 설정 변경 |
| `/gsd:debug [desc]` | 지속적인 상태를 유지하는 체계적인 디버깅 | 문제가 발생했을 때 |
| `/gsd:forensics` | 워크플로우 실패에 대한 진단 보고서 | 상태, 아티팩트, git 히스토리가 손상된 것 같을 때 |
| `/gsd:add-todo [desc]` | 나중을 위한 아이디어 캡처 | 세션 중에 생각이 날 때 |
| `/gsd:check-todos` | 보류 중인 할 일 목록 | 캡처된 아이디어 검토 시 |
| `/gsd:settings` | 워크플로우 토글 및 모델 프로필 설정 | 모델 변경, 에이전트 토글 시 |
| `/gsd:set-profile <profile>` | 빠른 프로필 전환 | 비용/품질 트레이드오프 변경 시 |
| `/gsd:reapply-patches` | 업데이트 후 로컬 수정사항 복원 | 로컬 편집이 있는 상태에서 `/gsd:update` 이후 |
| `/gsd-map-codebase` | 기존 코드베이스 분석 | 기존 코드에서 `/gsd-new-project` 실행 전 |
| `/gsd-quick` | GSD 보증을 갖춘 임시 작업 | 버그 수정, 소규모 기능, 설정 변경 |
| `/gsd-debug [desc]` | 지속적인 상태를 유지하는 체계적인 디버깅 | 문제가 발생했을 때 |
| `/gsd-forensics` | 워크플로우 실패에 대한 진단 보고서 | 상태, 아티팩트, git 히스토리가 손상된 것 같을 때 |
| `/gsd-add-todo [desc]` | 나중을 위한 아이디어 캡처 | 세션 중에 생각이 날 때 |
| `/gsd-check-todos` | 보류 중인 할 일 목록 | 캡처된 아이디어 검토 시 |
| `/gsd-settings` | 워크플로우 토글 및 모델 프로필 설정 | 모델 변경, 에이전트 토글 시 |
| `/gsd-set-profile <profile>` | 빠른 프로필 전환 | 비용/품질 트레이드오프 변경 시 |
| `/gsd-reapply-patches` | 업데이트 후 로컬 수정사항 복원 | 로컬 편집이 있는 상태에서 `/gsd-update` 이후 |
### 코드 품질 및 리뷰
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:review --phase N` | 외부 CLI를 통한 교차 AI 동료 리뷰 | 실행 전 계획 검증 시 |
| `/gsd:pr-branch` | `.planning/` 커밋을 필터링한 깔끔한 PR 브랜치 | 계획 없는 diff로 PR 생성 전 |
| `/gsd:audit-uat` | 모든 페이즈의 검증 부채 감사 | 마일스톤 완료 전 |
| `/gsd-review --phase N` | 외부 CLI를 통한 교차 AI 동료 리뷰 | 실행 전 계획 검증 시 |
| `/gsd-pr-branch` | `.planning/` 커밋을 필터링한 깔끔한 PR 브랜치 | 계획 없는 diff로 PR 생성 전 |
| `/gsd-audit-uat` | 모든 페이즈의 검증 부채 감사 | 마일스톤 완료 전 |
### 백로그 및 스레드
| 명령어 | 목적 | 사용 시점 |
|--------|------|----------|
| `/gsd:add-backlog <desc>` | 백로그 파킹 롯에 아이디어 추가 (999.x) | 활성 계획에 준비되지 않은 아이디어 |
| `/gsd:review-backlog` | 백로그 항목 승격/유지/제거 | 새 마일스톤 전 우선순위 결정 시 |
| `/gsd:plant-seed <idea>` | 트리거 조건이 있는 미래 지향적인 아이디어 | 미래 마일스톤에서 표면화되어야 할 아이디어 |
| `/gsd:thread [name]` | 지속적인 컨텍스트 스레드 | 페이즈 구조 밖의 교차 세션 작업 |
| `/gsd-add-backlog <desc>` | 백로그 파킹 롯에 아이디어 추가 (999.x) | 활성 계획에 준비되지 않은 아이디어 |
| `/gsd-review-backlog` | 백로그 항목 승격/유지/제거 | 새 마일스톤 전 우선순위 결정 시 |
| `/gsd-plant-seed <idea>` | 트리거 조건이 있는 미래 지향적인 아이디어 | 미래 마일스톤에서 표면화되어야 할 아이디어 |
| `/gsd-thread [name]` | 지속적인 컨텍스트 스레드 | 페이즈 구조 밖의 교차 세션 작업 |
---
## 설정 레퍼런스
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:new-project` 중에 설정하거나 나중에 `/gsd:settings`로 업데이트할 수 있습니다.
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd-new-project` 중에 설정하거나 나중에 `/gsd-settings`로 업데이트할 수 있습니다.
### 전체 config.json 스키마
@@ -519,7 +519,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
| `workflow.verifier` | `true`, `false` | `true` | 페이즈 목표에 대한 실행 후 검증 |
| `workflow.nyquist_validation` | `true`, `false` | `true` | plan-phase 중 검증 아키텍처 조사 및 8번째 plan-check 차원 |
| `workflow.ui_phase` | `true`, `false` | `true` | 프론트엔드 페이즈를 위한 UI 설계 계약 생성 |
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase가 프론트엔드 페이즈에서 /gsd:ui-phase 실행을 유도합니다 |
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase가 프론트엔드 페이즈에서 /gsd-ui-phase 실행을 유도합니다 |
| `workflow.research_before_questions` | `true`, `false` | `false` | 토론 질문 이후가 아닌 이전에 조사를 실행합니다 |
| `workflow.discuss_mode` | `standard`, `assumptions` | `standard` | 토론 방식: 개방형 질문 vs. 코드베이스 기반 가정 |
| `workflow.skip_discuss` | `true`, `false` | `false` | 자율 모드에서 discuss-phase를 완전히 건너뜁니다. ROADMAP 페이즈 목표에서 최소한의 CONTEXT.md를 작성합니다 |
@@ -540,7 +540,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | 브랜치 생성 시점과 방법 |
| `git.phase_branch_template` | 템플릿 문자열 | `gsd/phase-{phase}-{slug}` | phase 전략의 브랜치 이름 |
| `git.milestone_branch_template` | 템플릿 문자열 | `gsd/{milestone}-{slug}` | milestone 전략의 브랜치 이름 |
| `git.quick_branch_template` | 템플릿 문자열 또는 `null` | `null` | `/gsd:quick` 작업의 선택적 브랜치 이름 |
| `git.quick_branch_template` | 템플릿 문자열 또는 `null` | `null` | `/gsd-quick` 작업의 선택적 브랜치 이름 |
**브랜칭 전략 설명.**
@@ -590,60 +590,60 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
```bash
claude --dangerously-skip-permissions
/gsd:new-project # Answer questions, configure, approve roadmap
/gsd-new-project # Answer questions, configure, approve roadmap
/clear
/gsd:discuss-phase 1 # Lock in your preferences
/gsd:ui-phase 1 # Design contract (frontend phases)
/gsd:plan-phase 1 # Research + plan + verify
/gsd:execute-phase 1 # Parallel execution
/gsd:verify-work 1 # Manual UAT
/gsd:ship 1 # Create PR from verified work
/gsd:ui-review 1 # Visual audit (frontend phases)
/gsd-discuss-phase 1 # Lock in your preferences
/gsd-ui-phase 1 # Design contract (frontend phases)
/gsd-plan-phase 1 # Research + plan + verify
/gsd-execute-phase 1 # Parallel execution
/gsd-verify-work 1 # Manual UAT
/gsd-ship 1 # Create PR from verified work
/gsd-ui-review 1 # Visual audit (frontend phases)
/clear
/gsd:next # Auto-detect and run next step
/gsd-next # Auto-detect and run next step
...
/gsd:audit-milestone # Check everything shipped
/gsd:complete-milestone # Archive, tag, done
/gsd:session-report # Generate session summary
/gsd-audit-milestone # Check everything shipped
/gsd-complete-milestone # Archive, tag, done
/gsd-session-report # Generate session summary
```
### 기존 문서로 새 프로젝트 시작
```bash
/gsd:new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
/gsd-new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
/clear
/gsd:discuss-phase 1 # Normal flow from here
/gsd-discuss-phase 1 # Normal flow from here
```
### 기존 코드베이스
```bash
/gsd:map-codebase # Analyze what exists (parallel agents)
/gsd:new-project # Questions focus on what you're ADDING
/gsd-map-codebase # Analyze what exists (parallel agents)
/gsd-new-project # Questions focus on what you're ADDING
# (normal phase workflow from here)
```
### 빠른 버그 수정
```bash
/gsd:quick
/gsd-quick
> "Fix the login button not responding on mobile Safari"
```
### 휴식 후 재개
```bash
/gsd:progress # See where you left off and what's next
/gsd-progress # See where you left off and what's next
# or
/gsd:resume-work # Full context restoration from last session
/gsd-resume-work # Full context restoration from last session
```
### 릴리스 준비
```bash
/gsd:audit-milestone # Check requirements coverage, detect stubs
/gsd:plan-milestone-gaps # If audit found gaps, create phases to close them
/gsd:complete-milestone # Archive, tag, done
/gsd-audit-milestone # Check requirements coverage, detect stubs
/gsd-plan-milestone-gaps # If audit found gaps, create phases to close them
/gsd-complete-milestone # Archive, tag, done
```
### 속도 vs 품질 프리셋
@@ -654,16 +654,16 @@ claude --dangerously-skip-permissions
| 일반 개발 | `interactive` | `standard` | `balanced` | 켜기 | 켜기 | 켜기 |
| 프로덕션 | `interactive` | `fine` | `quality` | 켜기 | 켜기 | 켜기 |
**자율 모드에서 discuss-phase 건너뛰기:** PROJECT.md에 선호도가 이미 충분히 캡처된 `yolo` 모드에서 실행할 때 `/gsd:settings`에서 `workflow.skip_discuss: true`로 설정하세요. 이렇게 하면 discuss-phase를 완전히 우회하고 ROADMAP 페이즈 목표에서 파생된 최소한의 CONTEXT.md를 작성합니다. PROJECT.md와 관례가 충분히 포괄적이어서 토론이 새로운 정보를 제공하지 않을 때 유용합니다.
**자율 모드에서 discuss-phase 건너뛰기:** PROJECT.md에 선호도가 이미 충분히 캡처된 `yolo` 모드에서 실행할 때 `/gsd-settings`에서 `workflow.skip_discuss: true`로 설정하세요. 이렇게 하면 discuss-phase를 완전히 우회하고 ROADMAP 페이즈 목표에서 파생된 최소한의 CONTEXT.md를 작성합니다. PROJECT.md와 관례가 충분히 포괄적이어서 토론이 새로운 정보를 제공하지 않을 때 유용합니다.
### 마일스톤 중간 범위 변경
```bash
/gsd:add-phase # Append a new phase to the roadmap
/gsd-add-phase # Append a new phase to the roadmap
# or
/gsd:insert-phase 3 # Insert urgent work between phases 3 and 4
/gsd-insert-phase 3 # Insert urgent work between phases 3 and 4
# or
/gsd:remove-phase 7 # Descope phase 7 and renumber
/gsd-remove-phase 7 # Descope phase 7 and renumber
```
### 멀티 프로젝트 워크스페이스
@@ -672,18 +672,18 @@ claude --dangerously-skip-permissions
```bash
# Create a workspace with repos from your monorepo
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
# Feature branch isolation — worktree of current repo with its own .planning/
/gsd:new-workspace --name feature-b --repos .
/gsd-new-workspace --name feature-b --repos .
# Then cd into the workspace and initialize GSD
cd ~/gsd-workspaces/feature-b
/gsd:new-project
/gsd-new-project
# List and manage workspaces
/gsd:list-workspaces
/gsd:remove-workspace feature-b
/gsd-list-workspaces
/gsd-remove-workspace feature-b
```
각 워크스페이스는 다음을 포함합니다.
@@ -697,15 +697,15 @@ cd ~/gsd-workspaces/feature-b
### "Project already initialized"
`.planning/PROJECT.md`가 이미 존재하는데 `/gsd:new-project`를 실행했습니다. 이것은 안전 검사입니다. 처음부터 다시 시작하려면 먼저 `.planning/` 디렉터리를 삭제하세요.
`.planning/PROJECT.md`가 이미 존재하는데 `/gsd-new-project`를 실행했습니다. 이것은 안전 검사입니다. 처음부터 다시 시작하려면 먼저 `.planning/` 디렉터리를 삭제하세요.
### 긴 세션 중 컨텍스트 저하
주요 명령어 사이에 컨텍스트 윈도우를 지우세요: Claude Code에서 `/clear`를 사용합니다. GSD는 새로운 컨텍스트를 기반으로 설계되었습니다 — 모든 서브에이전트는 깨끗한 200K 윈도우를 받습니다. 메인 세션의 품질이 저하되면 지우고 `/gsd:resume-work` 또는 `/gsd:progress`를 사용하여 상태를 복원하세요.
주요 명령어 사이에 컨텍스트 윈도우를 지우세요: Claude Code에서 `/clear`를 사용합니다. GSD는 새로운 컨텍스트를 기반으로 설계되었습니다 — 모든 서브에이전트는 깨끗한 200K 윈도우를 받습니다. 메인 세션의 품질이 저하되면 지우고 `/gsd-resume-work` 또는 `/gsd-progress`를 사용하여 상태를 복원하세요.
### 계획이 잘못되거나 맞지 않는 경우
계획 전에 `/gsd:discuss-phase [N]`을 실행하세요. 대부분의 계획 품질 문제는 `CONTEXT.md`가 있었다면 방지할 수 있었던 가정을 Claude가 세우기 때문에 발생합니다. `/gsd:list-phase-assumptions [N]`을 실행하여 계획에 동의하기 전에 Claude가 무엇을 하려는지 확인할 수도 있습니다.
계획 전에 `/gsd-discuss-phase [N]`을 실행하세요. 대부분의 계획 품질 문제는 `CONTEXT.md`가 있었다면 방지할 수 있었던 가정을 Claude가 세우기 때문에 발생합니다. `/gsd-list-phase-assumptions [N]`을 실행하여 계획에 동의하기 전에 Claude가 무엇을 하려는지 확인할 수도 있습니다.
### 실행이 실패하거나 스텁을 생성하는 경우
@@ -713,15 +713,15 @@ cd ~/gsd-workspaces/feature-b
### 현재 위치를 잃어버린 경우
`/gsd:progress`를 실행하세요. 모든 상태 파일을 읽고 현재 위치와 다음에 할 일을 정확히 알려줍니다.
`/gsd-progress`를 실행하세요. 모든 상태 파일을 읽고 현재 위치와 다음에 할 일을 정확히 알려줍니다.
### 실행 후 변경이 필요한 경우
`/gsd:execute-phase`를 다시 실행하지 마세요. 목표를 정확히 수정하려면 `/gsd:quick`을 사용하거나 UAT를 통해 체계적으로 문제를 식별하고 수정하려면 `/gsd:verify-work`를 사용하세요.
`/gsd-execute-phase`를 다시 실행하지 마세요. 목표를 정확히 수정하려면 `/gsd-quick`을 사용하거나 UAT를 통해 체계적으로 문제를 식별하고 수정하려면 `/gsd-verify-work`를 사용하세요.
### 모델 비용이 너무 높은 경우
예산 프로필로 전환하세요: `/gsd:set-profile budget`. 도메인이 익숙하다면 (또는 Claude에게 익숙하다면) `/gsd:settings`에서 조사 및 plan-check 에이전트를 비활성화하세요.
예산 프로필로 전환하세요: `/gsd-set-profile budget`. 도메인이 익숙하다면 (또는 Claude에게 익숙하다면) `/gsd-settings`에서 조사 및 plan-check 에이전트를 비활성화하세요.
### 비Claude 런타임 사용 (Codex, OpenCode, Gemini CLI, Kilo)
@@ -746,19 +746,19 @@ cd ~/gsd-workspaces/feature-b
### 비Anthropic 공급자와 함께 Claude Code 사용 (OpenRouter, 로컬)
GSD 서브에이전트가 Anthropic 모델을 호출하는데 OpenRouter나 로컬 공급자를 통해 비용을 지불하고 있다면 `inherit` 프로필로 전환하세요: `/gsd:set-profile inherit`. 이렇게 하면 모든 에이전트가 특정 Anthropic 모델 대신 현재 세션 모델을 사용합니다. `/gsd:settings` → Model Profile → Inherit도 참고하세요.
GSD 서브에이전트가 Anthropic 모델을 호출하는데 OpenRouter나 로컬 공급자를 통해 비용을 지불하고 있다면 `inherit` 프로필로 전환하세요: `/gsd-set-profile inherit`. 이렇게 하면 모든 에이전트가 특정 Anthropic 모델 대신 현재 세션 모델을 사용합니다. `/gsd-settings` → Model Profile → Inherit도 참고하세요.
### 민감하거나 비공개 프로젝트에서 작업하는 경우
`/gsd:new-project` 중에 또는 `/gsd:settings`에서 `commit_docs: false`로 설정하세요. `.planning/`을 `.gitignore`에 추가하세요. 계획 아티팩트는 로컬에 유지되며 git에 절대 포함되지 않습니다.
`/gsd-new-project` 중에 또는 `/gsd-settings`에서 `commit_docs: false`로 설정하세요. `.planning/`을 `.gitignore`에 추가하세요. 계획 아티팩트는 로컬에 유지되며 git에 절대 포함되지 않습니다.
### GSD 업데이트가 로컬 변경사항을 덮어쓴 경우
v1.17부터 설치 프로그램이 로컬로 수정된 파일을 `gsd-local-patches/`에 백업합니다. 변경사항을 다시 병합하려면 `/gsd:reapply-patches`를 실행하세요.
v1.17부터 설치 프로그램이 로컬로 수정된 파일을 `gsd-local-patches/`에 백업합니다. 변경사항을 다시 병합하려면 `/gsd-reapply-patches`를 실행하세요.
### 워크플로우 진단 (`/gsd:forensics`)
### 워크플로우 진단 (`/gsd-forensics`)
워크플로우가 명확하지 않은 방식으로 실패할 때 — 계획이 존재하지 않는 파일을 참조하거나 실행이 예상치 못한 결과를 생성하거나 상태가 손상된 것 같을 때 — `/gsd:forensics`를 실행하여 진단 보고서를 생성하세요.
워크플로우가 명확하지 않은 방식으로 실패할 때 — 계획이 존재하지 않는 파일을 참조하거나 실행이 예상치 못한 결과를 생성하거나 상태가 손상된 것 같을 때 — `/gsd-forensics`를 실행하여 진단 보고서를 생성하세요.
**검사 항목.**
- Git 히스토리 이상 (고아 커밋, 예상치 못한 브랜치 상태, rebase 아티팩트)
@@ -780,7 +780,7 @@ Claude Code 분류 버그에 대한 알려진 해결 방법이 있습니다. GSD
All subagent/executor commits MUST use `--no-verify`.
```
병렬 실행을 완전히 비활성화하려면: `/gsd:settings` → `parallelization.enabled`를 `false`로 설정합니다.
병렬 실행을 완전히 비활성화하려면: `/gsd-settings` → `parallelization.enabled`를 `false`로 설정합니다.
### Windows: 보호된 디렉터리에서 설치 충돌
@@ -792,18 +792,18 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir`
| 문제 | 해결 방법 |
|------|----------|
| 컨텍스트 손실 / 새 세션 | `/gsd:resume-work` 또는 `/gsd:progress` |
| 컨텍스트 손실 / 새 세션 | `/gsd-resume-work` 또는 `/gsd-progress` |
| 페이즈가 잘못됨 | 페이즈 커밋에 `git revert` 후 재계획 |
| 범위 변경 필요 | `/gsd:add-phase`, `/gsd:insert-phase`, 또는 `/gsd:remove-phase` |
| 마일스톤 감사에서 갭 발견 | `/gsd:plan-milestone-gaps` |
| 무언가 고장남 | `/gsd:debug "description"` |
| 워크플로우 상태 손상 의심 | `/gsd:forensics` |
| 빠른 목표 수정 | `/gsd:quick` |
| 계획이 비전과 맞지 않음 | `/gsd:discuss-phase [N]` 후 재계획 |
| 비용이 높아짐 | `/gsd:set-profile budget` 및 `/gsd:settings`에서 에이전트 비활성화 |
| 업데이트가 로컬 변경사항 파괴 | `/gsd:reapply-patches` |
| 이해관계자를 위한 세션 요약 필요 | `/gsd:session-report` |
| 다음 단계를 모르겠음 | `/gsd:next` |
| 범위 변경 필요 | `/gsd-add-phase`, `/gsd-insert-phase`, 또는 `/gsd-remove-phase` |
| 마일스톤 감사에서 갭 발견 | `/gsd-plan-milestone-gaps` |
| 무언가 고장남 | `/gsd-debug "description"` |
| 워크플로우 상태 손상 의심 | `/gsd-forensics` |
| 빠른 목표 수정 | `/gsd-quick` |
| 계획이 비전과 맞지 않음 | `/gsd-discuss-phase [N]` 후 재계획 |
| 비용이 높아짐 | `/gsd-set-profile budget` 및 `/gsd-settings`에서 에이전트 비활성화 |
| 업데이트가 로컬 변경사항 파괴 | `/gsd-reapply-patches` |
| 이해관계자를 위한 세션 요약 필요 | `/gsd-session-report` |
| 다음 단계를 모르겠음 | `/gsd-next` |
| 병렬 실행 빌드 오류 | GSD 업데이트 또는 `parallelization.enabled: false` 설정 |
---
@@ -820,15 +820,15 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir`
STATE.md # Decisions, blockers, session memory
config.json # Workflow configuration
MILESTONES.md # Completed milestone archive
HANDOFF.json # Structured session handoff (from /gsd:pause-work)
research/ # Domain research from /gsd:new-project
reports/ # Session reports (from /gsd:session-report)
HANDOFF.json # Structured session handoff (from /gsd-pause-work)
research/ # Domain research from /gsd-new-project
reports/ # Session reports (from /gsd-session-report)
todos/
pending/ # Captured ideas awaiting work
done/ # Completed todos
debug/ # Active debug sessions
resolved/ # Archived debug sessions
codebase/ # Brownfield codebase mapping (from /gsd:map-codebase)
codebase/ # Brownfield codebase mapping (from /gsd-map-codebase)
phases/
XX-phase-name/
XX-YY-PLAN.md # Atomic execution plans
@@ -836,7 +836,7 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir`
CONTEXT.md # Your implementation preferences
RESEARCH.md # Ecosystem research findings
VERIFICATION.md # Post-execution verification results
XX-UI-SPEC.md # UI design contract (from /gsd:ui-phase)
XX-UI-REVIEW.md # Visual audit scores (from /gsd:ui-review)
ui-reviews/ # Screenshots from /gsd:ui-review (gitignored)
XX-UI-SPEC.md # UI design contract (from /gsd-ui-phase)
XX-UI-REVIEW.md # Visual audit scores (from /gsd-ui-review)
ui-reviews/ # Screenshots from /gsd-ui-review (gitignored)
```

View File

@@ -19,7 +19,7 @@
|------|-----------|---------------|
| Normal | > 35% | 경고 없음 |
| WARNING | <= 35% | 현재 작업 마무리, 새로운 복잡한 작업 시작 금지 |
| CRITICAL | <= 25% | 즉시 중단 후 상태 저장 (`/gsd:pause-work`) |
| CRITICAL | <= 25% | 즉시 중단 후 상태 저장 (`/gsd-pause-work`) |
## Debounce
@@ -56,7 +56,7 @@ additionalContext -> 에이전트가 경고를 받음
## GSD와의 통합
GSD의 `/gsd:pause-work` 명령어는 실행 상태를 저장합니다. WARNING 메시지는 해당 명령어 사용을 권장하며 CRITICAL 메시지는 즉각적인 상태 저장을 지시합니다.
GSD의 `/gsd-pause-work` 명령어는 실행 상태를 저장합니다. WARNING 메시지는 해당 명령어 사용을 권장하며 CRITICAL 메시지는 즉각적인 상태 저장을 지시합니다.
## 설정

View File

@@ -2,7 +2,7 @@
> **에이전트 작업자를 위한 안내:** 필수 하위 기술: superpowers:subagent-driven-development(권장) 또는 superpowers:executing-plans를 사용하여 이 계획을 작업 단위로 구현하세요. 단계는 체크박스(`- [ ]`) 형식으로 진행 상황을 추적합니다.
**목표:** `/gsd:new-project`가 `.planning/config.json`을 생성할 때, 파일에 사용자가 선택한 6개 키만이 아닌 모든 유효한 기본값이 포함되도록 하여 개발자가 소스 코드를 읽지 않고도 모든 설정을 확인할 수 있게 합니다.
**목표:** `/gsd-new-project`가 `.planning/config.json`을 생성할 때, 파일에 사용자가 선택한 6개 키만이 아닌 모든 유효한 기본값이 포함되도록 하여 개발자가 소스 코드를 읽지 않고도 모든 설정을 확인할 수 있게 합니다.
**아키텍처:** 새 프로젝트의 전체 config에 대한 단일 진실 공급원으로서 `config.cjs`에 단일 JS 함수 `buildNewProjectConfig(cwd, userChoices)`를 추가합니다. CLI 명령어 `config-new-project`로 노출합니다. 부분적인 JSON을 인라인으로 작성하는 대신 이 명령어를 호출하도록 `new-project.md` 워크플로우를 업데이트합니다.
@@ -316,7 +316,7 @@ function buildNewProjectConfig(cwd, userChoices) {
/**
* 명령어: 새 프로젝트를 위한 완전히 구체화된 .planning/config.json을 생성합니다.
*
* 사용자가 선택한 설정을 JSON 문자열로 받습니다(/gsd:new-project 중 명시적으로
* 사용자가 선택한 설정을 JSON 문자열로 받습니다(/gsd-new-project 중 명시적으로
* 구성한 키들). 나머지 키들은 하드코딩된 기본값과 선택적 ~/.gsd/defaults.json에서 채워집니다.
*
* 멱등성: config.json이 이미 존재하면 { created: false }를 반환합니다.
@@ -660,7 +660,7 @@ node --test tests/ 2>&1 | grep -E "pass|fail|error" | tail -5
feat: materialize all config defaults at new-project initialization
**문제:**
`/gsd:new-project`는 온보딩 중 사용자가 명시적으로 선택한 6개 키만으로
`/gsd-new-project`는 온보딩 중 사용자가 명시적으로 선택한 6개 키만으로
`.planning/config.json`을 생성합니다. 5개의 추가 키
(`search_gitignored`, `brave_search`, `git.branching_strategy`,
`git.phase_branch_template`, `git.milestone_branch_template`)는
@@ -669,7 +669,7 @@ feat: materialize all config defaults at new-project initialization
이로 인해 두 가지 문제가 발생합니다:
1. **발견성**: 소스 코드를 읽지 않고는 `git.branching_strategy`를
확인하거나 이해할 수 없습니다 — config에 표시되지 않습니다.
2. **암묵적 확장**: `/gsd:settings` 또는 `config-set`이 처음으로 config에
2. **암묵적 확장**: `/gsd-settings` 또는 `config-set`이 처음으로 config에
기록할 때도 해당 키들이 추가되지 않습니다. config는 유효한 구성의
일부만 반영합니다.

View File

@@ -1,4 +1,4 @@
# 멀티 프로젝트 워크스페이스 (`/gsd:new-workspace`)
# 멀티 프로젝트 워크스페이스 (`/gsd-new-workspace`)
**Issue:** #1241
**Date:** 2026-03-20
@@ -18,13 +18,13 @@ GSD는 작업 디렉토리당 하나의 `.planning/` 디렉토리에 종속되
## 명령어
### `/gsd:new-workspace`
### `/gsd-new-workspace`
저장소 복사본과 자체 `.planning/`이 있는 워크스페이스 디렉토리를 생성합니다.
```
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI --path ~/workspaces/feature-b
/gsd:new-workspace --name feature-b --repos . --strategy worktree # 동일 저장소 격리
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI --path ~/workspaces/feature-b
/gsd-new-workspace --name feature-b --repos . --strategy worktree # 동일 저장소 격리
```
**인수.**
@@ -38,11 +38,11 @@ GSD는 작업 디렉토리당 하나의 `.planning/` 디렉토리에 종속되
| `--branch` | 아니오 | `workspace/<name>` | 체크아웃할 브랜치 |
| `--auto` | 아니오 | false | 대화형 질문 건너뛰고 기본값 사용 |
### `/gsd:list-workspaces`
### `/gsd-list-workspaces`
워크스페이스 매니페스트를 위해 `~/gsd-workspaces/*/WORKSPACE.md`를 스캔합니다. 이름, 경로, 저장소 수, GSD 상태(PROJECT.md 존재 여부, 현재 페이즈)가 있는 표를 표시합니다.
### `/gsd:remove-workspace`
### `/gsd-remove-workspace`
확인 후 워크스페이스 디렉토리를 제거합니다. worktree 전략의 경우 먼저 각 멤버 저장소에 대해 `git worktree remove`를 실행합니다. 저장소에 커밋되지 않은 변경사항이 있으면 거부합니다.
@@ -52,7 +52,7 @@ GSD는 작업 디렉토리당 하나의 `.planning/` 디렉토리에 종속되
~/gsd-workspaces/feature-b/ # 워크스페이스 루트
├── WORKSPACE.md # 매니페스트
├── .planning/ # 독립적인 GSD 계획 디렉토리
│ ├── PROJECT.md # (사용자가 /gsd:new-project를 실행한 경우)
│ ├── PROJECT.md # (사용자가 /gsd-new-project를 실행한 경우)
│ ├── STATE.md
│ └── config.json
├── hr-ui/ # 소스 저장소의 git worktree
@@ -89,7 +89,7 @@ Strategy: worktree
## 워크플로우
### `/gsd:new-workspace` 워크플로우 단계
### `/gsd-new-workspace` 워크플로우 단계
1. **설정** — `init new-workspace` 호출, JSON 컨텍스트 파싱
2. **입력 수집** — `--name`/`--repos`/`--path`가 제공되지 않으면 대화형으로 질문합니다. 저장소의 경우 cwd의 하위 `.git` 디렉토리를 옵션으로 표시합니다.
@@ -100,7 +100,7 @@ Strategy: worktree
- Clone: `git clone <source> <workspace>/<repo-name>`
6. **WORKSPACE.md 작성** — 소스 경로, 전략, 브랜치가 있는 매니페스트
7. **.planning/ 초기화** — `mkdir -p <workspace>/.planning`
8. **/gsd:new-project 제안** — 새 워크스페이스에서 프로젝트 초기화를 실행할지 사용자에게 질문
8. **/gsd-new-project 제안** — 새 워크스페이스에서 프로젝트 초기화를 실행할지 사용자에게 질문
9. **커밋** — commit_docs가 활성화된 경우 WORKSPACE.md의 원자적 커밋
10. **완료** — 워크스페이스 경로와 다음 단계 출력