@hegemonart/get-design-done 1.59.5 → 1.59.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/.claude-plugin/marketplace.json +4 -4
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/CHANGELOG.md +54 -0
  4. package/README.md +219 -441
  5. package/SKILL.md +2 -2
  6. package/docs/i18n/README.de.md +212 -527
  7. package/docs/i18n/README.fr.md +203 -518
  8. package/docs/i18n/README.it.md +211 -526
  9. package/docs/i18n/README.ja.md +209 -524
  10. package/docs/i18n/README.ko.md +210 -525
  11. package/docs/i18n/README.zh-CN.md +215 -551
  12. package/package.json +1 -1
  13. package/reference/skill-graph.md +4 -1
  14. package/scripts/lib/install/doctor-codex-plugin.cjs +1 -1
  15. package/scripts/lib/install/doctor-cursor-marketplace.cjs +2 -2
  16. package/scripts/lib/manifest/skills.json +13 -0
  17. package/scripts/skill-templates/handoff/SKILL.md +99 -0
  18. package/skills/handoff/SKILL.md +99 -0
package/docs/i18n/README.ko.md CHANGED
@@ -4,9 +4,11 @@
4
4
 
5
5
  [English](../../README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · **한국어** · [Français](README.fr.md) · [Italiano](README.it.md) · [Deutsch](README.de.md)
6
6
 
7
- **AI 코딩 에이전트를 위한 디자인 품질 파이프라인: 브리프 → 탐색 → 계획 → 구현 → 검증.**
7
+ > 참고: 이 번역은 영어 버전보다 늦을 수 있습니다. 기준이 되는 버전은 [README.md](../../README.md) 입니다 (translation may lag behind English; see README.md for the canonical version).
8
8
 
9
- **Get Design Done은 AI가 생성한 UI가 브리프, 디자인 시스템, 레퍼런스, 품질 게이트에 계속 묶여 있도록 합니다. Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline에서 동작합니다.**
9
+ **AI 코딩 에이전트를 위한 디자인 품질 파이프라인: 브리프 -> 탐색 -> 계획 -> 디자인 -> 검증.**
10
+
11
+ **Get Design Done은 AI가 생성한 UI가 브리프, 디자인 시스템, 로컬 디자인 지식, 품질 게이트에 계속 묶여 있도록 합니다. Claude Code를 위해 만들어졌으며, Codex, Cursor, Gemini, OpenCode, Copilot, Windsurf 등에 설치됩니다.**
10
12
 
11
13
  [![npm version](https://img.shields.io/npm/v/@hegemonart/get-design-done?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@hegemonart/get-design-done)
12
14
  [![npm downloads](https://img.shields.io/npm/dm/@hegemonart/get-design-done?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@hegemonart/get-design-done)
@@ -15,612 +17,315 @@
15
17
  [![Node](https://img.shields.io/badge/node-22%20%7C%2024-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
16
18
  [![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
17
19
 
18
- <br>
19
-
20
20
  ```bash
21
21
  npx @hegemonart/get-design-done@latest
22
22
  ```
23
23
 
24
24
  **macOS, Linux, Windows에서 동작합니다.**
25
25
 
26
- <br>
27
-
28
- *"AI 코딩 에이전트는 UI를 빠르게 출시합니다. Get Design Done은 그것이 디자인으로 출시되게 만듭니다."*
29
-
30
- <br>
31
-
32
- [왜 만들었나](#왜-만들었나) · [작동 방식](#작동-방식) · [명령](#명령) · [연결](#연결) · [왜 동작하는가](#왜-동작하는가)
26
+ [설치](#설치) · [빠른 시작](#빠른-시작) · [활용 사례](#활용-사례) · [작동 방식](#작동-방식) · [명령](#명령) · [연결](#연결) · [안전성](#보안과-프라이버시)
33
27
 
34
28
  </div>
35
29
 
36
30
  ---
37
31
 
38
- > [!IMPORTANT]
39
- > ### 이미 Claude Design 번들이 있나요?
40
- >
41
- > [claude.ai/design](https://claude.ai/design)에서 디자인을 내보냈다면 1–3단계를 건너뛸 수 있습니다:
42
- >
43
- > ```
44
- > /gdd:handoff ./my-design.html
45
- > ```
46
- >
47
- > 번들의 CSS 사용자 정의 속성을 D-XX 디자인 결정으로 파싱하고, Handoff Faithfulness 채점이 포함된 검증 단계를 실행하며, 선택적으로 Figma에 구현 상태를 다시 기록합니다.
48
-
49
- ---
50
-
51
- ## 왜 만들었나
52
-
53
- 저는 AI 코딩 에이전트로 출시하는 디자이너입니다. 코드 측 워크플로는 이미 성숙합니다. 스펙, 태스크, 테스트, 커밋, 리뷰 루프가 있습니다. 디자인 측은 그렇지 않았습니다.
54
-
55
- 반복적으로 마주친 문제는 이렇습니다. 에이전트는 단독으로 보면 괜찮아 보이는 화면을 만들 수 있지만, 작업 자체는 *연결되지 않습니다*. 토큰이 기존 시스템과 맞지 않습니다. 대비비가 WCAG 아래로 떨어집니다. 위계가 화면마다 새로 만들어집니다. 오래된 안티패턴이 새 컴포넌트에 들어옵니다. 그리고 출력물을 원래 브리프에 대해 검증하는 것이 없기 때문에 문제는 PR 리뷰나 핸드오프 이후에야 늦게 드러납니다.
56
-
57
- 그래서 Get Design Done을 만들었습니다. AI 코딩 에이전트에게 개발자가 엔지니어링 워크플로에서 이미 기대하는 구조를 제공하는 디자인 파이프라인입니다. 브리프를 캡처하고, 현재 디자인 시스템을 매핑하고, 결정을 레퍼런스에 정합시키고, 작업을 원자적 태스크로 분해하고, 그 태스크를 실행한 뒤 출시 전에 결과를 검증합니다.
58
-
59
- 무대 뒤에는 37개의 전문 에이전트, 쿼리 가능한 인텔 저장소, 티어 인식 모델 라우팅, 12개의 선택적 도구 연결, 원자적 커밋, solidify-with-rollback 결과에서 학습하는 no-regret 적응 레이어가 있습니다. 일상적으로 보게 되는 것은 디자인 작업의 일관성을 지켜 주는 몇 개의 `/gdd:*` 명령입니다.
60
-
61
- — **Hegemon**
62
-
63
- ---
64
-
65
- AI 생성 디자인은 AI 생성 코드와 같은 실패 양상을 가집니다. 원하는 것을 설명하고 그럴듯한 결과를 받지만, 출력물을 브리프에 다시 묶는 시스템이 없기 때문에 규모가 커지면 무너집니다.
66
-
67
- Get Design Done은 디자인 작업을 위한 컨텍스트 엔지니어링 레이어입니다. "이 UI를 더 좋게 만들어 줘"를 추적 가능한 사이클로 바꿉니다: 브리프 → 인벤토리 → 레퍼런스 → 계획 → 구현 → 검증.
32
+ ## 무엇인가
68
33
 
69
- ---
34
+ Get Design Done은 AI 코딩 에이전트가 제품에 어울리는 UI를 출시하도록 돕습니다.
70
35
 
71
- ## 무엇을 얻을 수 있나
36
+ "이 화면을 더 좋게 만들어 줘" 같은 막연한 요청을 추적 가능한 디자인 워크플로로 바꿉니다: 브리프, 탐색, 계획, 디자인, 검증.
72
37
 
73
- - **브리프에 기반한 디자인 작업** — 모든 사이클은 문제, 대상 사용자, 제약, 성공 지표, 필수 요구사항에서 시작합니다.
74
- - **디자인 시스템 추출** — GDD는 변경을 계획하기 전에 토큰, 타이포그래피, 간격, 컴포넌트, 모션, 접근성, 다크 모드, 디자인 부채를 인벤토리합니다.
75
- - **레퍼런스 기반 결정** — 에이전트는 내장 디자인 레퍼런스와 선택적 Figma, Refero, Pinterest, Storybook, Chromatic, Preview, Claude Design, paper.design, pencil.dev, Graphify, 21st.dev Magic, Magic Patterns 연결을 사용합니다.
76
- - **원자적 실행** — 디자인 태스크는 의존성별로 분해되고, 안전한 wave로 실행되며, 독립적으로 커밋됩니다.
77
- - **출시 전 검증** — 감사는 브리프 적합성, 토큰 통합, WCAG 대비, 컴포넌트 적합성, 모션 일관성, 다크 모드 아키텍처, 디자인 안티패턴을 확인합니다.
78
- - **검증 실패 시 롤백** — solidify-with-rollback은 각 태스크가 남기 전에 검증합니다. 실패한 작업은 자동으로 되돌립니다.
79
-
80
- ---
38
+ 에이전트에게 감각만으로 즉흥적으로 만들라고 요청하는 대신, GDD는 구조화된 프로세스, 로컬 디자인 지식, 프로젝트별 메모리, 선택적 디자인 도구 연결, 그리고 작업이 출시되기 전의 검증을 제공합니다.
81
39
 
82
- ## 누구를 위한 것인가
40
+ ## 왜 존재하는가
83
41
 
84
- GDD는 AI 코딩 에이전트로 UI를 출시하고 첫 스크린샷을 넘어 결과가 견고하기를 원하는 엔지니어, 디자이너, 디자인 엔지니어, 창업자, 제품 빌더를 위한 것입니다.
42
+ AI 에이전트는 UI를 빠르게 만들어 냅니다. 어려운 부분은 그 UI를 일관되게 만드는 것입니다.
85
43
 
86
- 토큰이 일치하고, 대비가 WCAG를 통과하고, 모션이 일관되고, 컴포넌트가 시스템을 따르며, 최종 구현이 여전히 요청한 내용과 맞아야 한다면 사용하세요.
44
+ 디자인 워크플로가 없으면 생성된 인터페이스는 표류합니다:
87
45
 
88
- 디자이너일 필요는 없습니다. 파이프라인은 디자인 규율을 에이전트 워크플로에 가져옵니다. 컨텍스트를 추출하고, 빠진 결정만 질문하고, 작업을 레퍼런스에 정합시키며, 보통 너무 늦게 발견되는 문제를 먼저 잡습니다.
46
+ - 색상과 간격이 시스템과 맞지 않게 됩니다
47
+ - 컴포넌트가 다시 발명됩니다
48
+ - 대비와 접근성이 후퇴합니다
49
+ - 위계가 화면마다 달라집니다
50
+ - 구현이 더 이상 원래 브리프와 맞지 않습니다
89
51
 
90
- ### v1.24.0 하이라이트 — 다중 런타임 인스톨러
52
+ GDD는 AI 코딩 워크플로에 빠져 있던 디자인 규율을 더합니다. 문제를 캡처하고, 현재 디자인 시스템을 매핑하고, 범위가 정해진 변경을 계획하고, 원자적 단계로 실행한 뒤, 결과를 브리프, 토큰, 접근성, 디자인 품질 루브릭에 대해 검증합니다.
91
53
 
92
- - **`@clack/prompts` 인터랙티브 다중 선택** — `npx @hegemonart/get-design-done`을 플래그 없이 실행하면 14개의 지원 런타임(Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline)에 대한 체크박스 UI와 Global / Local 라디오가 표시됩니다.
93
- - **멱등 + 외부 AGENTS.md 안전** — 인스톨러를 다시 실행해도 항목이 중복되지 않으며, 런타임에 작성한 지시 파일을 덮어쓰지 않습니다. 어떤 파일이든 작성 전에 확인 단계가 있습니다.
94
- - **스크립트 CI 인터페이스 보존** — 기존의 모든 플래그(`--claude`, `--cursor`, `--all`, `--global`, `--local`, `--uninstall`, `--config-dir`)는 변경 없이 동작합니다. 인터랙티브 모드는 런타임 플래그가 전달되지 않을 때만 활성화됩니다.
95
- - **다중 선택 제거** — 런타임 플래그 없이 `--uninstall`을 사용하면 인터랙티브 다중 선택으로 진입하여 어느 런타임에서 제거할지 고를 수 있습니다.
54
+ 무대 뒤에는 64개의 전문 에이전트, 쿼리 가능한 인텔 저장소, 티어 인식 모델 라우팅, 39개의 선택적 도구 연결이 있습니다. 일상적으로 사용하는 것은 몇 개의 `/gdd:*` 명령입니다.
96
55
 
97
- ### 이전 릴리스
56
+ ## 설치
98
57
 
99
- - **v1.23.5** — No-Regret 적응 레이어(Thompson 샘플링 밴딧 + AdaNormalHedge 앙상블 + MMR 재랭킹; informed-prior 부트스트랩으로 단일 사용자 가능, opt-in 텔레메트리 불필요).
100
- - **v1.23.0** — SDK 도메인 프리미티브(solidify-with-rollback 게이트, JSON 출력 계약, `Touches:` 패턴 자동 결정화).
101
- - **v1.22.0** — SDK 관측 가능성(약 24개 타입 이벤트, 툴 콜별 트래젝토리, 추가 전용 이벤트 체인, 시크릿 스크러버).
102
- - **v1.21.0** — 헤드리스 SDK(Claude Code 없이 전체 파이프라인을 실행하는 `gdd-sdk` CLI, 병렬 리서처, 크로스 하니스 MCP).
103
- - **v1.20.0** — SDK 기반(회복력 프리미티브, lockfile 안전한 `STATE.md`, 11개 타입 도구를 가진 `gdd-state` MCP 서버, TypeScript 기반).
104
-
105
- 전체 릴리스 노트는 [CHANGELOG.md](CHANGELOG.md) 참조.
106
-
107
- ---
108
-
109
- <p align="center">
110
- <strong>Supported by</strong>
111
- </p>
112
-
113
- <div align="center">
114
- <a href="https://www.humbleteam.com/" aria-label="Humbleteam">
115
- <img src="docs/assets/sponsors/humbleteam.svg" alt="Humbleteam logo" width="180">
116
- </a>
117
- <br>
118
- <sub>Product design partner for ambitious startups and AI products.</sub>
119
- </div>
120
-
121
- ---
122
-
123
- ## 시작하기
58
+ ### npm
124
59
 
125
60
  ```bash
126
61
  npx @hegemonart/get-design-done@latest
127
62
  ```
128
63
 
129
- 인스톨러가 다음을 묻습니다:
130
- 1. **런타임** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline 또는 전체(인터랙티브 다중 선택)
131
- 2. **위치** — Global(모든 프로젝트) 또는 Local(현재 프로젝트만)
64
+ ### Claude Code
132
65
 
133
- 확인:
134
-
135
- ```
136
- /gdd:help
66
+ ```bash
67
+ /plugin marketplace add hegemonart/get-design-done
68
+ /plugin install get-design-done@get-design-done
69
+ /reload-plugins
137
70
  ```
138
71
 
139
- > [!TIP]
140
- > 마찰 없는 자동화 경험을 위해 Claude Code를 `--dangerously-skip-permissions`로 실행하는 것을 권장합니다. GDD는 자율적인 다단계 실행을 위해 설계되었습니다.
141
-
142
- ### 최신 상태 유지
143
-
144
- GDD는 자주 출시됩니다. 인스톨러를 다시 실행하면 됩니다(멱등):
72
+ ### Codex
145
73
 
146
74
  ```bash
147
- npx @hegemonart/get-design-done@latest
75
+ codex plugin marketplace add hegemonart/get-design-done
148
76
  ```
149
77
 
150
- 또는 Claude Code 안에서:
151
-
152
- ```
153
- /gdd:update
154
- ```
78
+ ### agentskills.io
155
79
 
156
- `/gdd:update`는 적용 전에 changelog를 미리 보여 줍니다. `reference/` 아래의 로컬 수정은 보존됩니다 — 구조적 업데이트 후 다시 스티치가 필요하면 `/gdd:reapply-patches`를 실행합니다.
80
+ [agentskills.io](https://agentskills.io) 스킬 레지스트리에서 Get Design Done을 둘러보고 설치하세요.
157
81
 
158
- <details>
159
- <summary><strong>비대화형 설치(Docker, CI, 스크립트)</strong></summary>
82
+ ### 런타임 직접 인스톨러
160
83
 
161
84
  ```bash
85
+ # Claude Code
162
86
  npx @hegemonart/get-design-done --claude --global
163
87
  npx @hegemonart/get-design-done --claude --local
164
- npx @hegemonart/get-design-done --opencode --global
165
- npx @hegemonart/get-design-done --gemini --global
166
- npx @hegemonart/get-design-done --kilo --global
88
+
89
+ # Other runtimes
167
90
  npx @hegemonart/get-design-done --codex --global
168
- npx @hegemonart/get-design-done --copilot --global
169
91
  npx @hegemonart/get-design-done --cursor --global
170
- npx @hegemonart/get-design-done --windsurf --global
171
- npx @hegemonart/get-design-done --antigravity --global
172
- npx @hegemonart/get-design-done --augment --global
173
- npx @hegemonart/get-design-done --trae --global
174
- npx @hegemonart/get-design-done --qwen --global
175
- npx @hegemonart/get-design-done --codebuddy --global
176
- npx @hegemonart/get-design-done --cline --global
177
-
178
- # 모든 런타임
92
+ npx @hegemonart/get-design-done --gemini --global
93
+
94
+ # Multi-runtime install
179
95
  npx @hegemonart/get-design-done --all --global
180
96
 
181
- # 드라이 런(diff만 출력, 쓰지 않음)
97
+ # Preview without writing
182
98
  npx @hegemonart/get-design-done --dry-run
183
-
184
- # 사용자 정의 설정 디렉터리(Docker 등)
185
- CLAUDE_CONFIG_DIR=/workspace/.claude npx @hegemonart/get-design-done
186
99
  ```
187
100
 
188
- </details>
101
+ ## 빠른 시작
189
102
 
190
- <details>
191
- <summary><strong>대안: Claude Code CLI</strong></summary>
103
+ 가벼운 첫 패스를 실행하세요:
192
104
 
193
105
  ```bash
194
- claude plugin marketplace add hegemonart/get-design-done
195
- claude plugin install get-design-done@get-design-done
106
+ /gdd:start
196
107
  ```
197
108
 
198
- </details>
199
-
200
- ### Tier-2 Distribution Channels (v1.28.8+)
201
-
202
- 위의 Phase 28.7 파일 드롭 설치 경로(기본값, 계속 작동)에 더해, v1.28.8은 세 가지 새로운 Tier-2 배포 채널을 추가합니다:
109
+ 또는 전체 디자인 사이클을 실행하세요:
203
110
 
204
- - **agentskills.io 크로스 런타임 호환성.** 우리 `skills/`는 [agentskills.io](https://agentskills.io) 사양을 준수합니다. agentskills.io 호환성을 표방하는 런타임(Codex, Kilo, Augment, Hermes, Qwen)이 이 채널을 통해 직접 스킬을 소비할 수 있습니다.
205
- - **Cursor Marketplace.** Cursor 마켓플레이스 UI를 통한 설치; Cursor 팀 리뷰 승인 대기 중 — `docs/cursor-marketplace-field-test.md` 참조.
206
- - **Codex Plugin.** Codex의 GitHub URL 플러그인 추가를 통한 설치:
207
-
208
- ```bash
209
- codex plugin marketplace add hegemonart/get-design-done
210
- ```
211
-
212
- 자세한 내용은 [README.md](README.md)(영어, 정본)을 참조하세요.
213
-
214
- ### Capability-Gap 텔레메트리 + 자가 저작 (v1.29.0+)
215
-
216
- 리플렉터 루프는 이제 "capability 조회 실패" 신호를 일급 텔레메트리로 추적하며, 충분히 반복되는 갭이 드러나면 새로운 agent 또는 skill을 리뷰용 제안으로 작성할 수 있습니다.
217
-
218
- **스테이지 0 — 텔레메트리(즉시 출시).** 세 가지 조회 실패 지점이 타입화된 `capability_gap` 이벤트를 발행합니다: `skills/fast` 스킬 미일치 경로, `gdd-router` 미일치 인텐트 경로, 리플렉터 패턴 감지 패스. `gdd-events --type capability_gap`으로 확인하세요.
219
-
220
- **스테이지 1 — 자가 저작(데이터가 게이트를 통과하면 옵트인).** K=3개의 안정 클러스터가 M=10 사이클에 걸쳐 나타나면, `/gdd:apply-reflections`가 스테이지 1 활성화 여부를 한 번 묻습니다. 그러면 리플렉터는 Phase 28.5 준수 frontmatter를 가진 인큐베이터 아티팩트를 `.design/reflections/incubator/<slug>/`에 초안 작성합니다. 4가지 액션: `accept` / `reject` / `defer` / `edit`. 엄격히 proposal-only — `/gdd:apply-reflections`가 유일한 인간 게이트입니다 (Phase 11 SC-8).
221
-
222
- 스코프 가드: 저작은 `agents/` 와 `skills/`에 한정되며 — 런타임 / 트랜스포트 / 훅은 대상이 아닙니다. 자세한 내용은 [README.md](README.md)(영어, 정본)을 참조하세요.
223
-
224
-
225
- ## 작동 방식
226
-
227
- > **기존 코드베이스에서 시작하나요?** 먼저 `/gdd:map`을 실행하세요. 5개의 전문 매퍼(tokens, components, visual hierarchy, a11y, motion)가 병렬로 디스패치되어 `.design/map/`에 구조화된 JSON을 작성합니다.
228
-
229
- ### 1. Brief(브리프)
230
-
231
- ```
111
+ ```bash
232
112
  /gdd:brief
233
- ```
234
-
235
- 스캔이나 탐색 전에 디자인 문제를 캡처합니다. `AskUserQuestion`을 통해 한 번에 한 질문씩 — 미답변 섹션에 대해서만: 문제, 대상, 제약, 성공 지표, 범위.
236
-
237
- **산출:** `.design/BRIEF.md`
238
-
239
- ---
240
-
241
- ### 2. Explore(탐색)
242
-
243
- ```
244
113
  /gdd:explore
245
- ```
246
-
247
- 현재 코드베이스의 디자인 시스템을 인벤토리합니다 — 색상, 타이포그래피, 간격, 컴포넌트, 모션, 접근성, 다크 모드. 5개 병렬 매퍼와 `design-discussant` 인터뷰가 세 개의 산출물을 만듭니다. 연결 프로브가 12개의 외부 도구 가용성을 감지합니다.
248
-
249
- **산출:** `.design/DESIGN.md`, `.design/DESIGN-DEBT.md`, `.design/DESIGN-CONTEXT.md`, `.design/map/{tokens,components,a11y,motion,visual-hierarchy}.{md,json}`
250
-
251
- ---
252
-
253
- ### 3. Plan(계획)
254
-
255
- ```
256
114
  /gdd:plan
115
+ /gdd:design
116
+ /gdd:verify
257
117
  ```
258
118
 
259
- Explore 산출물을 원자적이고 웨이브로 조정되며 의존성이 분석된 디자인 태스크로 분해합니다. 각 태스크는 명시적 `Touches:` 경로, 병렬 안전 태그, 수용 기준을 가집니다. `design-planner`(opus)가 작성하고 `design-plan-checker`(haiku)가 실행 전에 게이트 체크합니다.
260
-
261
- **산출:** `.design/DESIGN-PLAN.md`
119
+ 자연어 라우팅:
262
120
 
263
- ---
264
-
265
- ### 4. Design(실행)
266
-
267
- ```
268
- /gdd:design
121
+ ```bash
122
+ /gdd:do improve the checkout page hierarchy, spacing, and empty states
269
123
  ```
270
124
 
271
- 태스크를 웨이브 순서로 실행합니다. 각 태스크는 전용 `design-executor` 에이전트를 받아 신선한 200k 컨텍스트, 원자 git 커밋, 그리고 컨텍스트 내부 규칙에 따른 자동 편차 처리를 가집니다. 병렬 안전 태스크는 worktree에서 실행됩니다.
125
+ ## 활용 사례
272
126
 
273
- **Solidify-with-rollback**(v1.23.0) — 모든 태스크는 잠그기 전에 검증(typecheck + build + 타깃 테스트). 검증 실패 → `git stash` 되돌리기.
127
+ ### 기존 화면 개선
274
128
 
275
- **산출:** 태스크당 `.design/tasks/task-NN.md`, 태스크당 원자 git 커밋
129
+ 화면이 기술적으로는 동작하지만 시각적으로 일관되지 않거나, 불명확하거나, 디자인이 덜 된 느낌일 때 GDD를 사용하세요.
276
130
 
277
- ```
278
- ┌────────────────────────────────────────────────────────────────────┐
279
- │ WAVE 실행 │
280
- ├────────────────────────────────────────────────────────────────────┤
281
- │ │
282
- │ WAVE 1(병렬) WAVE 2(병렬) WAVE 3 │
283
- │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
284
- │ │ Task 01 │ │ Task 02 │ → │ Task 03 │ │ Task 04 │ → │ Task 05 │ │
285
- │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
286
- │ │ │ ↑ ↑ ↑ │
287
- │ └───────────┴──────────────┴───────────┴──────────────┘ │
288
- │ Touches: 경로가 의존성 분석을 주도 │
289
- │ │
290
- └────────────────────────────────────────────────────────────────────┘
131
+ ```bash
132
+ /gdd:do improve the settings page layout and component hierarchy
291
133
  ```
292
134
 
293
- ---
135
+ ### AI 출력물을 디자인 시스템으로 되돌리기
294
136
 
295
- ### 5. Verify(검증)
137
+ 에이전트가 그럴듯해 보이지만 토큰, 간격, 상태, 컴포넌트와 맞지 않는 UI를 생성했을 때 사용하세요.
296
138
 
297
- ```
139
+ ```bash
298
140
  /gdd:verify
299
141
  ```
300
142
 
301
- 브리프에 대해 검증합니다 — 필수 항목, NN/g 휴리스틱, 감사 채점, 토큰 통합. 세 에이전트가 순차적으로 실행: `design-auditor`(6 기둥 1–4 채점), `design-verifier`(목표 역방향), `design-integration-checker`(D-XX 결정을 코드에 grep). 실패 시 구조화된 갭 리스트와 `design-fixer`를 통한 verify→fix 루프.
143
+ ### 출시 전 감사
302
144
 
303
- **산출:** `.design/DESIGN-VERIFICATION.md`, 문제 발견 시 갭 수정 커밋
145
+ PR, 릴리스, 디자인 핸드오프 전에 검증을 실행하세요.
304
146
 
305
- ---
147
+ ```bash
148
+ /gdd:audit
149
+ ```
306
150
 
307
- ### 6. Ship → Reflect → 다음 사이클
151
+ ### 다크 모드 수정
308
152
 
309
- ```
310
- /gdd:ship # 깨끗한 PR 브랜치 생성(.design/ 커밋 필터링)
311
- /gdd:reflect # design-reflector가 텔레메트리 + 학습 사항 읽음
312
- /gdd:apply-reflections # reflector 제안 검토 및 선택적 적용
313
- /gdd:complete-cycle # 사이클 산출물 아카이브 + 사이클별 EXPERIENCE.md 작성
314
- /gdd:new-cycle # 새 디자인 사이클 시작
153
+ ```bash
154
+ /gdd:darkmode
315
155
  ```
316
156
 
317
- 또는 자동 라우팅:
157
+ ### 디자인 핸드오프 임포트
318
158
 
319
- ```
320
- /gdd:next # 상태 자동 감지 후 다음 단계 실행
159
+ ```bash
160
+ /gdd:handoff ./my-design.html
321
161
  ```
322
162
 
323
- 각 사이클은 브리프, 스캔, 계획, 실행, 검증, 100–200줄의 사이클별 `EXPERIENCE.md`(목표 / 결정 / 학습 / 폐기 / 다음 사이클로의 핸드오프)를 가지며, 이는 decision-injector 훅의 최우선 소스가 됩니다.
324
-
325
- ---
163
+ 이것은 Claude Design 번들을 파싱하여 CSS 사용자 정의 속성을 디자인 결정으로 추출하고, 핸드오프 충실도 검사를 실행합니다.
326
164
 
327
- ### Fast 모드
165
+ ### 작고 집중된 수정
328
166
 
329
- ```
330
- /gdd:fast "<task>"
167
+ ```bash
168
+ /gdd:fast "fix contrast in pricing cards"
331
169
  ```
332
170
 
333
- 전체 파이프라인이 필요 없는 단일 파일의 사소한 수정. 라우터, 캐시 매니저, 텔레메트리를 건너뜁니다. 동일한 원자 커밋 보장.
171
+ ## 무엇이 다른가
334
172
 
335
- ```
336
- /gdd:quick
337
- ```
173
+ ### 로컬 디자인 지식
338
174
 
339
- GDD 보장이 필요하지만 선택적 게이트(phase-researcher, assumptions analyzer, integration-checker)는 건너뛰는 임시 태스크.
175
+ GDD는 디자인 작업을 위한 방대한 로컬 레퍼런스 라이브러리를 함께 제공합니다. 에이전트는 기본적인 디자인 판단을 위해 실시간 웹 검색에 의존하지 않고도 이를 사용할 수 있습니다.
340
176
 
341
- ---
177
+ 접근성, WCAG, 타이포그래피, 간격, 그리드, 색상, 대비, 표면, 모션, UX 라이팅, 폼, 빈 상태, 시각 위계, 다크 모드, 반응형 동작, i18n, 리서치 방법, 감사 채점, 디자인 안티패턴을 다룹니다.
342
178
 
343
- ## 왜 동작하는가
179
+ 에이전트는 빈 프롬프트에서 시작하지 않습니다. 계획, 구현, 검증 동안 적용할 수 있는 공유된 디자인 어휘와 구체적인 표준을 가지고 있습니다.
344
180
 
345
- ### 컨텍스트 엔지니어링
181
+ 전체 맵: [docs/KNOWLEDGE-BASE.md](docs/KNOWLEDGE-BASE.md)
346
182
 
347
- AI 코딩 CLI는 컨텍스트를 충분히 주면 강력합니다. 대부분의 사람들은 그렇게 하지 않습니다.
183
+ ### 프로젝트별 메모리
348
184
 
349
- GDD가 대신 처리합니다:
185
+ GDD는 각 사이클을 기반에 묶어 두는 `.design/` 워크스페이스를 만듭니다:
350
186
 
351
- | 파일 | 역할 |
352
- |------|------|
353
- | `.design/BRIEF.md` | 사이클의 문제, 대상, 성공 지표 |
354
- | `.design/DESIGN.md` | 현재 디자인 시스템 스냅샷(토큰, 컴포넌트, 위계) |
355
- | `.design/DESIGN-CONTEXT.md` | D-XX 결정, 인터뷰 답변, 상하류 제약 |
356
- | `.design/DESIGN-PLAN.md` | 원자 태스크, 웨이브 안무, 의존성 |
357
- | `.design/DESIGN-VERIFICATION.md` | 검증 결과, 갭 리스트, Handoff Faithfulness 점수 |
358
- | `.design/intel/` | 쿼리 가능한 지식 레이어 |
359
- | `.design/archive/cycle-N/EXPERIENCE.md` | 사이클별 회고, 사이클 간 메모리 |
360
- | `.design/telemetry/events.jsonl` | 단계 간 타입 이벤트 스트림 |
361
- | `.design/telemetry/posterior.json` | 밴딧 사후분포(`adaptive_mode != static`일 때) |
362
-
363
- Claude의 품질 저하 경계에 맞춘 사이즈 한도. 그 아래에 머무르면 일관된 우수성을 얻습니다.
187
+ | 산출물 | 목적 |
188
+ | --- | --- |
189
+ | `.design/BRIEF.md` | 문제, 대상, 범위, 성공 지표 |
190
+ | `.design/DESIGN.md` | 현재 디자인 시스템 스냅샷 |
191
+ | `.design/DESIGN-CONTEXT.md` | 결정, 제약, 레퍼런스 |
192
+ | `.design/DESIGN-PLAN.md` | 원자적 구현 계획 |
193
+ | `.design/DESIGN-VERIFICATION.md` | 최종 감사 및 갭 보고 |
194
+ | `.design/intel/` | 쿼리 가능한 프로젝트 지식: 토큰, 컴포넌트, 관계, 결정 |
195
+ | `.design/archive/` | 완료된 사이클 이력과 학습 사항 |
364
196
 
365
- ### 37개의 전문 에이전트
197
+ 오래 사용할수록 에이전트가 다시 발견해야 할 것이 줄어듭니다.
366
198
 
367
- 각 단계는 얇은 오케스트레이터가 전문 에이전트를 스폰하는 패턴입니다.
199
+ ### 출시 전 검증
368
200
 
369
- | 단계 | 오케스트레이터 | 에이전트 |
370
- |------|--------------|---------|
371
- | Brief | 한 질문 인터뷰 | (서브에이전트 없음) |
372
- | Explore | 5 매퍼 + discussant 스폰 | 5 병렬 매퍼, design-discussant, research-synthesizer |
373
- | Plan | 리서처 + planner + checker 스폰 | design-phase-researcher(선택), design-planner(opus), design-plan-checker(haiku) |
374
- | Design | 웨이브 조정 + worktree 격리 | 태스크별 design-executor, solidify 실패 시 design-fixer |
375
- | Verify | auditor + verifier + checker 스폰 | design-auditor, design-verifier, design-integration-checker |
376
- | Reflect | 텔레메트리 + 학습 읽기 | design-reflector(opus), design-authority-watcher, design-update-checker |
201
+ GDD는 UI가 "다 된 것처럼 보일" 때 멈추지 않습니다.
377
202
 
378
- ### 12개의 도구 연결
203
+ 검증 단계는 결과가 여전히 다음과 맞는지 확인합니다:
379
204
 
380
- 전부 선택적 — 어떤 연결이든 사용 불가일 때 파이프라인은 우아하게 폴백:
205
+ - 원래 브리프
206
+ - 디자인 시스템 토큰
207
+ - 접근성 임계값
208
+ - 컴포넌트 규약
209
+ - 시각 위계
210
+ - 모션 및 인터랙션 규칙
211
+ - 기록된 디자인 결정
381
212
 
382
- - **Figma**(읽기 + 쓰기 + Code Connect)
383
- - **Refero** — 디자인 레퍼런스 검색
384
- - **Pinterest** — 시각 레퍼런스
385
- - **Claude Design** — 핸드오프 번들 임포트
386
- - **Storybook** — 컴포넌트 사양 조회
387
- - **Chromatic** — 비주얼 회귀 베이스라인 diff
388
- - **Preview** — Playwright + Claude Preview MCP 런타임 스크린샷
389
- - **paper.design** — MCP 캔버스 읽기/쓰기
390
- - **pencil.dev** — git 추적 `.pen` 사양 파일
391
- - **Graphify** — 지식 그래프 익스포트
392
- - **21st.dev Magic** — greenfield 빌드 전 선례 검색
393
- - **Magic Patterns** — DS-aware 컴포넌트 생성
213
+ 갭이 나타나면, GDD는 리뷰를 감각에 맡기는 대신 구조화된 수정 목록을 만들어 냅니다.
394
214
 
395
- ### 내장 디자인 레퍼런스
215
+ ### 스킬 동작 테스트
396
216
 
397
- 플러그인은 **18개 이상의 레퍼런스 파일**을 제공합니다 — NN/g 10가지, Don Norman 감성 디자인, Dieter Rams 10원칙, Disney 12원칙(모션), Sonner / Emil Kowalski 컴포넌트 작성 렌즈, Peak-End, Loss Aversion, Cognitive Load, Aesthetic-Usability, Doherty, Flow, 35개 컴포넌트 사양, gestalt, 시각 위계, 브랜드 보이스, 161개 산업별 팔레트, 67개 UI 미학, 12개 모션 이징, 8개 트랜지션 패밀리, WCAG 2.1 AA, 플랫폼(iOS/Android/web/visionOS/watchOS), RTL/CJK, 폼 패턴, 안티패턴 카탈로그.
217
+ GDD 자체 스킬은 적대적 압박 시나리오(시간 압박, 매몰 비용, 권위, 범위 최소화) 아래에서 시험되어, 무너지지 않고 규율을 유지하는지 확인합니다. 압박 시나리오를 추가하는 방법은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.
398
218
 
399
- ### 원자적 git 커밋
219
+ ## 작동 방식
400
220
 
221
+ ```text
222
+ Brief -> Explore -> Plan -> Design -> Verify -> Ship
401
223
  ```
402
- abc123f docs(08-02): complete user-card token plan
403
- def456g feat(08-02): unify card surface tokens with --color-bg-elevated
404
- hij789k feat(08-02): replace inline padding with --space-* scale
405
- lmn012o test(08-02): assert card.spec passes WCAG contrast 4.5:1
406
- ```
407
-
408
- git bisect가 정확히 실패한 태스크를 찾습니다. 각 태스크는 독립적으로 되돌릴 수 있습니다. Solidify-with-rollback이 태스크 수준 검증 게이트를 추가하여, 깨진 태스크 3이 verify 실행 전에 태스크 4–10을 오염시키지 못하도록 합니다.
409
-
410
- ### 자가 개선 루프
411
-
412
- 각 사이클 후, `design-reflector`(opus)가 `events.jsonl`, `agent-metrics.json`, `learnings/`를 읽고 diff를 제안합니다 — 티어 오버라이드, 병렬화 규칙, 레퍼런스 추가, frontmatter 업데이트. `/gdd:apply-reflections`가 적용 전에 diff를 보여 주고 묻습니다.
413
-
414
- **No-Regret 적응 레이어**(v1.23.5)는 그 위에 Thompson 샘플링 밴딧 + AdaNormalHedge 앙상블 + MMR 재랭킹을 얹어, informed-prior 부트스트랩으로 단일 사용자에서도 동작합니다.
415
224
 
416
- ### 비용 거버넌스
225
+ | 단계 | 명령 | 산출 |
226
+ | --- | --- | --- |
227
+ | Brief | `/gdd:brief` | 디자인 문제를 캡처 |
228
+ | Explore | `/gdd:explore` | UI 시스템, 부채, 토큰, 컴포넌트를 매핑 |
229
+ | Plan | `/gdd:plan` | 원자적 디자인 태스크를 생성 |
230
+ | Design | `/gdd:design` | 검증과 함께 태스크를 실행 |
231
+ | Verify | `/gdd:verify` | 최종 결과를 감사 |
417
232
 
418
- - **`gdd-router` 스킬** — 결정론적 인텐트 → fast / quick / full 라우팅, 모델 호출 없음.
419
- - **`gdd-cache-manager`** — Layer-B 명시적 캐시, SHA-256 입력 해시, 5분 TTL 인식.
420
- - **`budget-enforcer` PreToolUse 훅** — `.design/budget.json`에서 티어 오버라이드, 하드 캡, 지연 스폰 게이트 강제.
421
- - **스폰별 비용 텔레메트리** — `.design/telemetry/costs.jsonl`이 `/gdd:optimize` 권장에 공급.
233
+ ### 핵심 산출물
422
234
 
423
- 목표: 품질 저하 없이 태스크당 토큰 비용 50–70% 감소.
424
-
425
- ---
235
+ | 파일 | 역할 |
236
+ | --- | --- |
237
+ | `.design/BRIEF.md` | 사이클의 문제, 대상, 성공 지표 |
238
+ | `.design/DESIGN.md` | 현재 디자인 시스템 스냅샷 |
239
+ | `.design/DESIGN-CONTEXT.md` | 디자인 결정과 제약 |
240
+ | `.design/DESIGN-PLAN.md` | 원자적 태스크, 웨이브, 의존성 |
241
+ | `.design/DESIGN-VERIFICATION.md` | 검증 결과와 갭 목록 |
242
+ | `.design/intel/` | 이 프로젝트를 위한 쿼리 가능한 지식 레이어 |
426
243
 
427
244
  ## 명령
428
245
 
246
+ GDD는 96개의 스킬을 제공합니다. 다음은 대부분의 사용자가 일상적으로 필요로 하는 것들입니다. 전체 레퍼런스는 [SKILL.md](SKILL.md)를 참조하세요.
247
+
429
248
  ### 핵심 파이프라인
430
249
 
431
- | 명령 | 작용 |
432
- |------|------|
433
- | `/gdd:brief` | 단계 1 — 디자인 브리프 캡처 |
434
- | `/gdd:explore` | 단계 2 — 코드베이스 인벤토리 + 인터뷰 |
435
- | `/gdd:plan` | 단계 3 — DESIGN-PLAN.md 생성 |
436
- | `/gdd:design` | 단계 4 — 웨이브 단위로 실행 |
437
- | `/gdd:verify` | 단계 5 — 브리프에 대해 검증 |
438
- | `/gdd:ship` | 깨끗한 PR 브랜치 생성 |
439
- | `/gdd:next` | STATE.md 기반 다음 단계 자동 라우팅 |
440
- | `/gdd:do <text>` | 자연어 라우터 |
441
- | `/gdd:fast <text>` | 일회성 사소한 수정, 파이프라인 없음 |
442
- | `/gdd:quick` | GDD 보장이 있는 임시 태스크, 선택적 게이트 건너뛰기 |
443
-
444
- ### 첫 실행 + 온보딩
445
-
446
- | 명령 | 작용 |
447
- |------|------|
448
- | `/gdd:start` | 첫 실행 증명 경로 — 저장소 내 디자인 이슈 상위 3개 |
449
- | `/gdd:new-project` | GDD 프로젝트 초기화 |
450
- | `/gdd:connections` | 12개의 외부 통합을 위한 온보딩 위저드 |
451
-
452
- ### 사이클 라이프사이클
453
-
454
- | 명령 | 작용 |
455
- |------|------|
456
- | `/gdd:new-cycle` | 새 디자인 사이클 |
457
- | `/gdd:complete-cycle` | 사이클 산출물 아카이브 + EXPERIENCE.md |
458
- | `/gdd:pause` / `/gdd:resume` | 번호가 매겨진 체크포인트 |
459
- | `/gdd:continue` | `/gdd:resume`의 별칭 |
460
- | `/gdd:timeline` | 사이클 + git log 회고 |
461
-
462
- ### 반복 + 결정
463
-
464
- | 명령 | 작용 |
465
- |------|------|
466
- | `/gdd:discuss [topic]` | 적응형 디자인 인터뷰 |
467
- | `/gdd:list-assumptions` | 계획 전에 숨은 디자인 가정 노출 |
468
- | `/gdd:sketch [idea]` | 다중 변형 HTML 목업 |
469
- | `/gdd:spike [idea]` | 시간 제한 가능성 실험 |
470
- | `/gdd:sketch-wrap-up` / `/gdd:spike-wrap-up` | 발견사항을 프로젝트 로컬 스킬로 패키징 |
471
- | `/gdd:audit` | 검증 + 감사 + 리플렉터 묶음 |
472
- | `/gdd:reflect` | 온디맨드 리플렉터 실행 |
473
- | `/gdd:apply-reflections` | 리플렉터 제안 검토 및 선택적 적용 |
474
-
475
- ### 메모리 + 지식 레이어
476
-
477
- | 명령 | 작용 |
478
- |------|------|
479
- | `/gdd:recall <query>` | FTS5 검색 |
480
- | `/gdd:extract-learnings` | 사이클 산출물에서 패턴/결정/교훈 추출 |
481
- | `/gdd:note <text>` | 마찰 없는 아이디어 캡처 |
482
- | `/gdd:plant-seed <idea>` | 트리거 조건이 있는 미래 지향 아이디어 |
483
- | `/gdd:analyze-dependencies` | 토큰 팬아웃, 컴포넌트 콜그래프, 결정 추적성 |
484
- | `/gdd:skill-manifest` | 모든 GDD 스킬과 에이전트 나열 |
485
- | `/gdd:graphify` | 프로젝트 지식 그래프 빌드/쿼리/diff |
486
- | `/gdd:watch-authorities` | 디자인 권위 피드 diff |
487
-
488
- ### 연결
489
-
490
- | 명령 | 작용 |
491
- |------|------|
492
- | `/gdd:figma-write` | Figma에 디자인 결정 다시 쓰기 |
250
+ | 명령 | 목적 |
251
+ | --- | --- |
252
+ | `/gdd:brief` | 디자인 브리프 캡처 |
253
+ | `/gdd:explore` | 현재 UI 시스템 인벤토리 |
254
+ | `/gdd:plan` | 디자인 계획 생성 |
255
+ | `/gdd:design` | 계획 실행 |
256
+ | `/gdd:verify` | 결과 검증 |
257
+ | `/gdd:ship` | 깨끗한 PR 브랜치 준비 |
258
+ | `/gdd:next` | 다음 단계로 자동 라우팅 |
259
+
260
+ ### 일상 사용
261
+
262
+ | 명령 | 목적 |
263
+ | --- | --- |
264
+ | `/gdd:do <task>` | 자연어 라우터 |
265
+ | `/gdd:fast <task>` | 작고 집중된 수정 |
266
+ | `/gdd:quick` | 가벼운 태스크 흐름 |
267
+ | `/gdd:audit` | 디자인 품질 감사 |
268
+ | `/gdd:darkmode` | 다크 모드 감사 |
269
+ | `/gdd:style <component>` | 컴포넌트 스타일 핸드오프 |
270
+ | `/gdd:health` | 파이프라인 상태 진단 |
271
+ | `/gdd:progress` | 현재 사이클 진행 상황 표시 |
272
+ | `/gdd:resume` | 체크포인트에서 재개 |
273
+
274
+ ### 디자인 도구 및 핸드오프
275
+
276
+ | 명령 | 목적 |
277
+ | --- | --- |
278
+ | `/gdd:connections` | 선택적 통합 구성 |
279
+ | `/gdd:figma-extract` | Figma 디자인 시스템 컨텍스트 추출 |
280
+ | `/gdd:figma-write` | 결정과 상태를 Figma에 다시 쓰기 |
493
281
  | `/gdd:handoff <bundle>` | Claude Design 번들 임포트 |
494
- | `/gdd:darkmode` | 다크 모드 구현 감사 |
495
- | `/gdd:compare` | DESIGN.md와 DESIGN-VERIFICATION.md 차이 계산 |
496
- | `/gdd:style <Component>` | 컴포넌트 핸드오프 문서 생성 |
497
-
498
- ### 진단 + 포렌식
499
-
500
- | 명령 | 작용 |
501
- |------|------|
502
- | `/gdd:scan` | 코드베이스 디자인 시스템 인벤토리 |
503
- | `/gdd:map` | 5 병렬 코드베이스 매퍼 |
504
- | `/gdd:debug [desc]` | 증상 주도 디자인 조사 |
505
- | `/gdd:health` | `.design/` 산출물 건강 보고 |
506
- | `/gdd:progress` | 파이프라인 위치 표시 |
507
- | `/gdd:stats` | 사이클 통계 |
508
- | `/gdd:optimize` | 규칙 기반 비용 분석 |
509
- | `/gdd:warm-cache` | Anthropic 캐시 사전 워밍 |
510
-
511
- ### 배포 + 업데이트
512
-
513
- | 명령 | 작용 |
514
- |------|------|
515
- | `/gdd:update` | GDD 업데이트, changelog 미리 보기 |
516
- | `/gdd:reapply-patches` | 구조 업데이트 후 로컬 수정 다시 스티치 |
517
- | `/gdd:check-update` | 수동 업데이트 확인 |
518
- | `/gdd:settings` | `.design/config.json` 구성 |
519
- | `/gdd:set-profile <profile>` | 모델 프로필 전환 |
520
- | `/gdd:undo` | 안전한 디자인 변경 되돌리기 |
521
- | `/gdd:pr-branch` | 깨끗한 PR 브랜치 |
522
-
523
- ### 백로그 + 노트
524
-
525
- | 명령 | 작용 |
526
- |------|------|
527
- | `/gdd:todo` | 디자인 태스크 추가/나열/선택 |
528
- | `/gdd:add-backlog <idea>` | 미래 사이클을 위한 디자인 아이디어 보관 |
529
- | `/gdd:review-backlog` | 보관 항목 검토 |
530
-
531
- ### 도움
532
-
533
- | 명령 | 작용 |
534
- |------|------|
535
- | `/gdd:help` | 전체 명령 목록과 사용법 |
536
- | `/gdd:bandit-reset` | Anthropic 모델 출시 시 적응 레이어 사후분포 리셋 |
282
+ | `/gdd:sketch <idea>` | 다중 변형 HTML 목업 생성 |
283
+ | `/gdd:spike <idea>` | 시간 제한 가능성 패스 |
537
284
 
538
- ---
285
+ 전체 명령 레퍼런스: [SKILL.md](SKILL.md)
539
286
 
540
287
  ## 연결
541
288
 
542
- GDD는 12개의 도구 연결을 제공합니다. 모두 선택 사항. `/gdd:connections`로 구성합니다.
543
-
544
- | 연결 | 목적 | 프로브 |
545
- |------|------|--------|
546
- | **Figma** | 토큰/컴포넌트/스크린샷 읽기, 주석/Code Connect/구현 상태 쓰기 | `mcp__figma__get_metadata` + `use_figma` |
547
- | **Refero** | 디자인 레퍼런스 검색 | `mcp__refero__search` |
548
- | **Pinterest** | 브랜드 + 스타일 비주얼 레퍼런스 | OAuth + MCP |
549
- | **Claude Design** | 핸드오프 번들 임포트 | URL 또는 로컬 파일 |
550
- | **Storybook** | 6006 포트 컴포넌트 사양 조회 | HTTP 프로브 |
551
- | **Chromatic** | 비주얼 회귀 베이스라인 diff | API 키 |
552
- | **Preview** | Playwright + Claude Preview MCP | `mcp__Claude_Preview__preview_*` |
553
- | **paper.design** | MCP 캔버스 읽기/쓰기 | `mcp__paper__use_paper` |
554
- | **pencil.dev** | git 추적 `.pen` 사양 | 저장소 내 `.pen` 파일 |
555
- | **Graphify** | 지식 그래프 익스포트 | `mcp__graphify__*` |
556
- | **21st.dev Magic** | greenfield 전 선례 검색 | `mcp__magic__search` |
557
- | **Magic Patterns** | DS-aware 컴포넌트 생성 | `mcp__magic-patterns__generate` |
558
-
559
- 전체 연결 세부 정보는 [`connections/connections.md`](connections/connections.md) 참조.
560
-
561
- ---
289
+ GDD는 외부 도구 없이도 동작하지만, 39개의 선택적 통합에 연결할 수 있습니다. 모두 선택 사항이며, 어떤 연결이든 사용 불가일 때 파이프라인은 폴백으로 우아하게 degrade합니다.
562
290
 
563
- ## 구성
291
+ 연결 레이어는 다음 카테고리에 걸쳐 있습니다:
564
292
 
565
- GDD는 프로젝트 설정을 `.design/config.json`에 저장합니다. `/gdd:new-project` 동안 구성하거나 `/gdd:settings`로 업데이트.
293
+ - **디자인 표면** - Figma (읽기 + 쓰기 + Code Connect), paper.design, pencil.dev, Penpot, Framer, Webflow, Plasmic
294
+ - **레퍼런스 및 리서치** - Refero, Pinterest, Lazyweb, Mobbin, Claude Design 핸드오프
295
+ - **컴포넌트 생성** - 21st.dev Magic, Magic Patterns, v0.dev, Builder.io
296
+ - **컴포넌트 사양 및 비주얼 QA** - Storybook, Chromatic, Preview (Playwright + Claude Preview MCP)
297
+ - **지식 그래프** - Graphify
298
+ - **네이티브 및 비웹 출력** - Xcode Simulator, Android Emulator, Litmus / Email-on-Acid, 인쇄 렌더러
299
+ - **모션 검증** - Lottie, Rive
300
+ - **팀 표면** - Slack, Discord, Linear, Jira, Notion, GitHub PR
566
301
 
567
- ### 모델 프로필
302
+ 통합 구성:
568
303
 
569
- | 프로필 | 계획 | 실행 | 검증 |
570
- |--------|------|------|------|
571
- | `quality` | Opus | Opus | Sonnet |
572
- | `balanced`(기본) | Opus | Sonnet | Sonnet |
573
- | `budget` | Sonnet | Sonnet | Haiku |
574
- | `inherit` | Inherit | Inherit | Inherit |
575
-
576
- ```
577
- /gdd:set-profile budget
304
+ ```bash
305
+ /gdd:connections
578
306
  ```
579
307
 
580
- ### 적응 모드
581
-
582
- `.design/budget.json#adaptive_mode` 사다리(v1.23.5):
583
-
584
- | 모드 | 작용 |
585
- |------|------|
586
- | `static`(기본) | Phase 10.1 동작 |
587
- | `hedge` | AdaNormalHedge 앙상블 + MMR 재랭킹 활성화. 가장 안전한 입문. |
588
- | `full` | 밴딧 라우터 + Hedge + MMR 모두 활성 |
308
+ 프로브 패턴이 포함된 전체 연결 목록은 [connections/connections.md](connections/connections.md)를 참조하세요.
589
309
 
590
- ### 병렬 처리
310
+ ## 요구사항
591
311
 
592
- | 설정 | 기본 | 제어 |
593
- |------|------|------|
594
- | `parallelism.enabled` | `true` | worktree에서 독립적 태스크 실행 |
595
- | `parallelism.min_estimated_savings_seconds` | `30` | 이 임계 아래에서는 병렬화 건너뛰기 |
596
- | `parallelism.max_concurrent_workers` | `4` | 동시 worker 하드 캡 |
312
+ - Node.js 22 또는 24
313
+ - Git
314
+ - 지원되는 AI 코딩 런타임
597
315
 
598
- ### 품질 게이트
316
+ ## 다중 런타임 지원
599
317
 
600
- | 설정 | 기본 | 제어 |
601
- |------|------|------|
602
- | `solidify.rollback_mode` | `"stash"` | `stash` / `hard` / `none` |
603
- | `solidify.commands` | 자동 감지 | typecheck / build / test 명령 재정의 |
604
- | `verify.iterations_max` | `3` | verify→fix 루프 상한 |
605
- | `connection.figma_writeback` | `proposal` | `proposal` / `auto` |
606
-
607
- ---
318
+ GDD는 14개의 AI 코딩 런타임에 설치됩니다: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Kilo, Copilot, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline. 동일한 소스 스킬과 에이전트가 런타임별 변환기에 의해 각 런타임의 네이티브 레이아웃(`skills/`, `command/`, `agents/`, 또는 `.clinerules`)으로 컴파일되므로, 파이프라인이 에디터를 넘나들며 당신과 함께 이동합니다.
608
319
 
609
- ## 보안
320
+ Claude Code가 대표 런타임입니다. 전체 경험은 그곳에서 처음부터 끝까지 실행됩니다: 모든 에이전트, 심층 방어 훅, MCP 기반 연결. 다른 런타임에서는 동일한 스킬과 에이전트를 네이티브 형태로 얻고, MCP 기반 연결은 MCP를 지원하는 호스트에서 활성화되며, 훅 레이어는 Claude Code 전용입니다.
610
321
 
611
- ### 내장 강화
322
+ ## 보안과 프라이버시
612
323
 
613
- GDD는 Phase 14.5부터 심층 방어를 제공합니다:
324
+ GDD는 기본적으로 로컬 우선입니다. 프로젝트 산출물을 `.design/` 아래에 작성하고, 구성된 경우에만 선택적 통합을 사용하며, 이슈 리포팅은 동의 기반으로 유지합니다.
614
325
 
615
- - **`hooks/gdd-bash-guard.js`** — PreToolUse:Bash가 약 50개의 위험 패턴 차단(`rm -rf /`, `chmod 777`, `curl | sh`, `git reset --hard`, fork 폭탄), Unicode NFKC + ANSI 정규화 후.
616
- - **`hooks/gdd-protected-paths.js`** — PreToolUse:Edit/Write/Bash가 `protected_paths` glob 리스트 강제.
617
- - **`hooks/gdd-read-injection-scanner.ts`** — 인바운드 Read 콘텐츠에서 보이지 않는 Unicode, HTML 코멘트, 시크릿 유출 패턴 스캔.
618
- - **`scripts/lib/blast-radius.cjs`** — `design-executor` 사전 점검이 `max_files_per_task: 10` / `max_lines_per_task: 400`을 초과하는 태스크 거부.
619
- - **`hooks/gdd-mcp-circuit-breaker.js`** — `use_figma` / `use_paper` / `use_pencil`에서 연속 타임아웃 루프 차단.
326
+ 플러그인에는 보호된 경로, 위험 명령 차단, 인젝션 스캔, MCP 서킷 브레이킹, 예산 강제를 위한 심층 방어 훅이 포함됩니다. GDD는 또한 안전한 프로젝트 인트로스펙션을 위한 13개의 읽기 전용 MCP 도구를 제공합니다.
620
327
 
621
- ### 민감 파일 보호
622
-
623
- 런타임의 deny 리스트에 민감 경로 추가:
328
+ 런타임의 deny 리스트에 민감 경로를 추가하세요:
624
329
 
625
330
  ```json
626
331
  {
@@ -629,7 +334,6 @@ GDD는 Phase 14.5부터 심층 방어를 제공합니다:
629
334
  "Read(.env)",
630
335
  "Read(.env.*)",
631
336
  "Read(**/secrets/*)",
632
- "Read(**/*credential*)",
633
337
  "Read(**/*.pem)",
634
338
  "Read(**/*.key)"
635
339
  ]
@@ -637,77 +341,58 @@ GDD는 Phase 14.5부터 심층 방어를 제공합니다:
637
341
  }
638
342
  ```
639
343
 
640
- > [!IMPORTANT]
641
- > GDD가 LLM 시스템 프롬프트가 되는 마크다운 파일을 생성하기 때문에, `.design/` 산출물로 흘러들어가는 사용자 제어 텍스트는 잠재적인 간접 프롬프트 인젝션 벡터입니다. 인젝션 스캐너가 여러 레이어에서 잡지만, 심층 방어가 모범 사례입니다.
642
-
643
- ---
644
-
645
- ## 문제 해결
646
-
647
- **설치 후 명령을 찾을 수 없나요?**
648
- - 런타임 재시작
649
- - `~/.claude/skills/get-design-done/`(전역) 또는 `./.claude/skills/get-design-done/`(로컬) 확인
650
- - `/gdd:help`로 등록 확인
651
-
652
- **파이프라인이 단계 중간에 멈추나요?**
653
- - `/gdd:resume` — 가장 최근 번호 체크포인트에서 복원
654
- - `/gdd:health` — `.design/` 산출물 문제 진단
655
- - `/gdd:progress --forensic` — 6 점검 무결성 감사
344
+ 읽기: [SECURITY.md](SECURITY.md) · [PRIVACY.md](PRIVACY.md)
656
345
 
657
- **비용 초과?**
658
- - `/gdd:optimize` — 규칙 기반 권장
659
- - `/gdd:set-profile budget` — 예산 티어로 전환
660
- - `.design/budget.json`에서 `adaptive_mode: "full"` 설정 — 밴딧이 5–10 사이클 안에 학습
346
+ ## 업데이트
661
347
 
662
- **최신 버전으로 업데이트?**
663
348
  ```bash
664
349
  npx @hegemonart/get-design-done@latest
665
350
  ```
666
351
 
667
- **Docker / 컨테이너?**
352
+ 또는 Claude Code 안에서:
668
353
 
669
354
  ```bash
670
- CLAUDE_CONFIG_DIR=/workspace/.claude npx @hegemonart/get-design-done
355
+ /gdd:update
671
356
  ```
672
357
 
673
- ### 제거
358
+ 전체 릴리스 이력은 [CHANGELOG.md](CHANGELOG.md)를 참조하세요.
674
359
 
675
- ```bash
676
- # 전역 제거(런타임별)
677
- npx @hegemonart/get-design-done --claude --global --uninstall
678
- npx @hegemonart/get-design-done --opencode --global --uninstall
679
- # ... 14개 런타임에 대해 동일한 --<runtime> --global --uninstall 패턴
360
+ ## 문제 해결
680
361
 
681
- # 다중 선택 인터랙티브 제거(런타임 플래그 없이)
682
- npx @hegemonart/get-design-done --uninstall
362
+ ### 명령이 나타나지 않음
683
363
 
684
- # 로컬 제거
685
- npx @hegemonart/get-design-done --claude --local --uninstall
686
- # ... --local 플래그
687
- ```
364
+ 런타임을 재시작하고 실행하세요:
688
365
 
689
- 다른 구성을 보존하면서 모든 GDD 명령, 에이전트, 훅, 설정을 제거합니다.
366
+ ```bash
367
+ /gdd:help
368
+ ```
690
369
 
691
- ---
370
+ ### 파이프라인이 멈춤
692
371
 
693
- ## 피드백 채널 (v1.30.0+)
372
+ ```bash
373
+ /gdd:health
374
+ /gdd:resume
375
+ ```
694
376
 
695
- GDD에는 이제 `/gdd:report-issue` 슬래시 명령어를 통한 동의 기반 GitHub 이슈 리포터가 포함되어 있습니다.
377
+ ### 비용이 너무 높음
696
378
 
697
- - **무엇을 하나요.** 이슈 또는 기능 부족을 보고하도록 안내하며, 제출 전에 페이로드를 미리 봅니다. 로컬 우선, 동의 기반, 자동 모드 없음.
698
- - **익명화가 아닌 가명화입니다.** 직접 식별자(사용자 이름, 호스트 이름, 절대 경로, Git ID, 환경 변수 값, 이메일, IP 주소)는 안정적인 가명으로 대체되지만, 메인테이너가 디버깅할 수 있도록 내부 상관관계는 유지됩니다. 사이드 채널 데이터(글쓰기 스타일, 코드 패턴, 저장소 지문)는 여전히 재식별될 수 있습니다. 제출 전에 전체 페이로드를 보고 이슈별로 명시적으로 동의합니다.
699
- - **킬 스위치.** 네트워크 호출 전에 제출을 중단하려면 `GDD_DISABLE_ISSUE_REPORTER=1`(환경) 또는 `.design/config.json`에 `{ "issue_reporter": false }`를 추가하세요.
700
- - **`gh` 부재 시 폴백.** GitHub CLI가 설치되어 있지 않으면 페이로드가 `.design/issue-drafts/`에 디스크에 기록되고 이슈 템플릿 URL이 클립보드에 복사됩니다.
379
+ ```bash
380
+ /gdd:optimize
381
+ ```
701
382
 
702
- 전체 세부 사항은 영어 [`README.md`](README.md)를, 규칙 카탈로그(R1..R8)는 [`reference/pseudonymization-rules.md`](reference/pseudonymization-rules.md)를, 알려진 실패 모드는 [`reference/known-failure-modes.md`](reference/known-failure-modes.md)를 참조하세요.
383
+ ## 기여
703
384
 
704
- **v1.30.5 업데이트** — 카탈로그가 22개 항목(v1.30.0에서는 10개)으로 확장되었고, 새로운 결정론적 퍼지 매처(`scripts/lib/failure-mode-matcher.cjs`)가 신뢰도 점수와 함께 top-N 후보를 반환합니다. Reflector + authority-watcher는 `/gdd:apply-reflections`(6번째 제안 클래스)를 통해 새 항목을 제안할 수 있습니다 — 엄격하게 제안 전용이며 모든 항목은 사용자 검토를 거칩니다.
385
+ ```bash
386
+ npm install
387
+ npm test
388
+ npm run typecheck
389
+ ```
705
390
 
706
- ---
391
+ 읽기: [CONTRIBUTING.md](CONTRIBUTING.md)
707
392
 
708
393
  ## 라이선스
709
394
 
710
- MIT 라이선스. 자세한 내용은 [LICENSE](LICENSE) 참조.
395
+ MIT 라이선스. 자세한 내용은 [LICENSE](LICENSE)를 참조하세요. 서드파티 표기는 [NOTICE](NOTICE)에 나열되어 있습니다.
711
396
 
712
397
  ---
713
398