ccgx-workflow 1.0.0 → 1.0.1

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 (60) hide show
  1. package/README.md +37 -5
  2. package/README.zh-CN.md +35 -5
  3. package/dist/cli.mjs +1 -1
  4. package/dist/index.mjs +2 -2
  5. package/dist/shared/{ccgx-workflow.WgUzkiC3.mjs → ccgx-workflow.SJPbUy5_.mjs} +17 -110
  6. package/package.json +2 -1
  7. package/templates/commands/agents/phase-runner.md +321 -321
  8. package/templates/commands/autonomous.md +792 -792
  9. package/templates/commands/cancel.md +132 -132
  10. package/templates/commands/debug.md +226 -226
  11. package/templates/commands/status.md +206 -206
  12. package/templates/commands/team.md +484 -0
  13. package/templates/hooks/ccg-session-state.cjs +510 -510
  14. package/templates/scripts/ccg-phase-runner-launcher.mjs +467 -467
  15. package/templates/scripts/invoke-model.mjs +64 -0
  16. package/templates/skills/domains/ai/SKILL.md +35 -35
  17. package/templates/skills/domains/ai/agent-dev.md +242 -242
  18. package/templates/skills/domains/ai/llm-security.md +288 -288
  19. package/templates/skills/domains/ai/rag-system.md +542 -542
  20. package/templates/skills/domains/architecture/SKILL.md +43 -43
  21. package/templates/skills/domains/architecture/api-design.md +225 -225
  22. package/templates/skills/domains/architecture/cloud-native.md +285 -285
  23. package/templates/skills/domains/architecture/security-arch.md +297 -297
  24. package/templates/skills/domains/data-engineering/SKILL.md +208 -208
  25. package/templates/skills/domains/development/SKILL.md +47 -47
  26. package/templates/skills/domains/development/cpp.md +246 -246
  27. package/templates/skills/domains/development/go.md +323 -323
  28. package/templates/skills/domains/development/java.md +277 -277
  29. package/templates/skills/domains/development/python.md +288 -288
  30. package/templates/skills/domains/development/rust.md +313 -313
  31. package/templates/skills/domains/development/shell.md +313 -313
  32. package/templates/skills/domains/development/typescript.md +277 -277
  33. package/templates/skills/domains/devops/SKILL.md +40 -40
  34. package/templates/skills/domains/devops/database.md +217 -217
  35. package/templates/skills/domains/devops/devsecops.md +198 -198
  36. package/templates/skills/domains/devops/git-workflow.md +181 -181
  37. package/templates/skills/domains/devops/testing.md +283 -283
  38. package/templates/skills/domains/frontend-design/SKILL.md +244 -244
  39. package/templates/skills/domains/frontend-design/claymorphism/SKILL.md +121 -121
  40. package/templates/skills/domains/frontend-design/component-patterns.md +202 -202
  41. package/templates/skills/domains/frontend-design/glassmorphism/SKILL.md +142 -142
  42. package/templates/skills/domains/frontend-design/liquid-glass/SKILL.md +139 -139
  43. package/templates/skills/domains/frontend-design/neubrutalism/SKILL.md +145 -145
  44. package/templates/skills/domains/frontend-design/state-management.md +680 -680
  45. package/templates/skills/domains/frontend-design/ui-aesthetics.md +110 -110
  46. package/templates/skills/domains/frontend-design/ux-principles.md +156 -156
  47. package/templates/skills/domains/infrastructure/SKILL.md +201 -201
  48. package/templates/skills/domains/mobile/SKILL.md +225 -225
  49. package/templates/skills/domains/orchestration/SKILL.md +30 -30
  50. package/templates/skills/domains/orchestration/multi-agent.md +228 -228
  51. package/templates/skills/domains/security/SKILL.md +73 -73
  52. package/templates/skills/domains/security/blue-team.md +436 -436
  53. package/templates/skills/domains/security/code-audit.md +265 -265
  54. package/templates/skills/domains/security/pentest.md +226 -226
  55. package/templates/skills/domains/security/red-team.md +374 -374
  56. package/templates/skills/domains/security/threat-intel.md +372 -372
  57. package/templates/skills/domains/security/vuln-research.md +369 -369
  58. package/templates/skills/tools/lib/shared.js +98 -98
  59. package/templates/skills/tools/override-refusal/SKILL.md +53 -53
  60. package/templates/skills/tools/override-refusal/scripts/refusal_rewriter.js +226 -226
@@ -1,244 +1,244 @@
1
- ---
2
- name: frontend-design
3
- description: "前端设计秘典(Impeccable 融合版:排版/OKLCH 配色/空间/动效/交互/响应式/UX 文案 + 4 种 style 变体)。"
4
- license: "Apache 2.0 (Impeccable) + MIT (custom extensions)"
5
- user-invocable: false
6
- disable-model-invocation: false
7
- context: fork
8
- paths: "*.tsx,*.jsx,*.vue,*.svelte,*.css,*.scss"
9
- ---
10
-
11
- # Frontend Design (Impeccable Fusion Edition)
12
-
13
- This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. It fuses [Impeccable](https://github.com/pbakaus/impeccable) design philosophy with extended knowledge on state management, engineering, and design style systems.
14
-
15
- ---
16
-
17
- ## Context Gathering Protocol
18
-
19
- Design skills produce generic output without project context. You MUST have confirmed design context before doing any design work.
20
-
21
- **Required context** — every design skill needs at minimum:
22
- - **Target audience**: Who uses this product and in what context?
23
- - **Use cases**: What jobs are they trying to get done?
24
- - **Brand personality/tone**: How should the interface feel?
25
-
26
- **Gathering order:**
27
- 1. **Check current instructions (instant)**: If your loaded instructions already contain a **Design Context** section, proceed immediately.
28
- 2. **Check .impeccable.md (fast)**: If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed.
29
- 3. **Run /teach-impeccable (REQUIRED)**: If neither source has context, you MUST run `/teach-impeccable` NOW before doing anything else. Do NOT skip this step. Do NOT attempt to infer context from the codebase instead.
30
-
31
- ---
32
-
33
- ## Design Direction
34
-
35
- Commit to a BOLD aesthetic direction:
36
- - **Purpose**: What problem does this interface solve? Who uses it?
37
- - **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc.
38
- - **Constraints**: Technical requirements (framework, performance, accessibility).
39
- - **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
40
-
41
- **CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work — the key is intentionality, not intensity.
42
-
43
- ---
44
-
45
- ## Frontend Aesthetics Guidelines
46
-
47
- ### Typography
48
- > *Consult [typography reference](reference/typography.md) for scales, pairing, and loading strategies.*
49
-
50
- Choose fonts that are beautiful, unique, and interesting. Pair a distinctive display font with a refined body font.
51
-
52
- **DO**: Use a modular type scale with fluid sizing (clamp) for display text; fixed rem scales for app UIs
53
- **DO**: Vary font weights and sizes to create clear visual hierarchy
54
- **DON'T**: Use overused fonts — Inter, Roboto, Arial, Open Sans, system defaults
55
- **DON'T**: Use monospace typography as lazy shorthand for "technical/developer" vibes
56
- **DON'T**: Put large icons with rounded corners above every heading — they rarely add value
57
-
58
- ### Color & Theme
59
- > *Consult [color reference](reference/color-and-contrast.md) for OKLCH, palettes, and dark mode.*
60
-
61
- Commit to a cohesive palette. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.
62
-
63
- **DO**: Use OKLCH (not HSL) for perceptually uniform, maintainable palettes
64
- **DO**: Tint your neutrals toward your brand hue — even a subtle hint creates subconscious cohesion
65
- **DON'T**: Use gray text on colored backgrounds — use a shade of the background color instead
66
- **DON'T**: Use pure black (#000) or pure white (#fff) — always tint
67
- **DON'T**: Use the AI color palette: cyan-on-dark, purple-to-blue gradients, neon accents on dark backgrounds
68
- **DON'T**: Use gradient text for "impact" — it's decorative rather than meaningful
69
- **DON'T**: Default to dark mode with glowing accents
70
-
71
- ### Layout & Space
72
- > *Consult [spatial reference](reference/spatial-design.md) for grids, rhythm, and container queries.*
73
-
74
- **DO**: Create visual rhythm through varied spacing — tight groupings, generous separations
75
- **DO**: Use fluid spacing with clamp() that breathes on larger screens
76
- **DO**: Use asymmetry and unexpected compositions; break the grid intentionally
77
- **DON'T**: Wrap everything in cards — not everything needs a container
78
- **DON'T**: Nest cards inside cards — flatten the hierarchy
79
- **DON'T**: Use identical card grids — same-sized cards with icon + heading + text, repeated endlessly
80
- **DON'T**: Center everything — left-aligned text with asymmetric layouts feels more designed
81
- **DON'T**: Use the same spacing everywhere — without rhythm, layouts feel monotonous
82
-
83
- ### Visual Details
84
- **DO**: Use intentional, purposeful decorative elements that reinforce brand
85
- **DON'T**: Use glassmorphism everywhere — blur effects used decoratively rather than purposefully
86
- **DON'T**: Use rounded elements with thick colored border on one side — a lazy accent
87
- **DON'T**: Use sparklines as decoration — tiny charts that convey nothing meaningful
88
- **DON'T**: Use rounded rectangles with generic drop shadows — safe, forgettable
89
- **DON'T**: Use modals unless there's truly no better alternative
90
-
91
- ### Motion
92
- > *Consult [motion reference](reference/motion-design.md) for timing, easing, and reduced motion.*
93
-
94
- **DO**: Use motion to convey state changes — entrances, exits, feedback
95
- **DO**: Use exponential easing (ease-out-quart/quint/expo) for natural deceleration
96
- **DO**: For height animations, use grid-template-rows transitions
97
- **DON'T**: Animate layout properties (width, height, padding, margin) — use transform and opacity only
98
- **DON'T**: Use bounce or elastic easing — they feel dated and tacky
99
-
100
- ### Interaction
101
- > *Consult [interaction reference](reference/interaction-design.md) for forms, focus, and loading patterns.*
102
-
103
- **DO**: Use progressive disclosure — start simple, reveal sophistication through interaction
104
- **DO**: Design empty states that teach the interface, not just say "nothing here"
105
- **DO**: Make every interactive surface feel intentional and responsive
106
- **DON'T**: Repeat the same information — redundant headers, intros that restate the heading
107
- **DON'T**: Make every button primary — hierarchy matters
108
-
109
- ### Responsive
110
- > *Consult [responsive reference](reference/responsive-design.md) for mobile-first, fluid design, and container queries.*
111
-
112
- **DO**: Use container queries (@container) for component-level responsiveness
113
- **DO**: Adapt the interface for different contexts — don't just shrink it
114
- **DON'T**: Hide critical functionality on mobile — adapt, don't amputate
115
-
116
- ### UX Writing
117
- > *Consult [ux-writing reference](reference/ux-writing.md) for labels, errors, and empty states.*
118
-
119
- **DO**: Make every word earn its place
120
- **DON'T**: Repeat information users can already see
121
-
122
- ---
123
-
124
- ## The AI Slop Test
125
-
126
- **Critical quality check**: If you showed this interface to someone and said "AI made this," would they believe you immediately? If yes, that's the problem.
127
-
128
- A distinctive interface should make someone ask "how was this made?" not "which AI made this?"
129
-
130
- Review the DON'T guidelines above — they are the fingerprints of AI-generated work from 2024-2025.
131
-
132
- ---
133
-
134
- ## Reference Library (Impeccable)
135
-
136
- Deep-dive reference documents for each design dimension:
137
-
138
- | Reference | Covers |
139
- |-----------|--------|
140
- | [typography](reference/typography.md) | Type systems, font pairing, modular scales, OpenType, web font loading |
141
- | [color-and-contrast](reference/color-and-contrast.md) | OKLCH, tinted neutrals, dark mode, accessibility, 60-30-10 |
142
- | [spatial-design](reference/spatial-design.md) | 4pt spacing, grids, visual hierarchy, container queries, optical adjustments |
143
- | [motion-design](reference/motion-design.md) | 100/300/500 rule, easing curves, stagger, reduced motion, perceived performance |
144
- | [interaction-design](reference/interaction-design.md) | 8 states, focus rings, Popover API, CSS Anchor, modals, keyboard nav |
145
- | [responsive-design](reference/responsive-design.md) | Content-driven breakpoints, pointer/hover queries, safe areas, srcset |
146
- | [ux-writing](reference/ux-writing.md) | Button labels, error formulas, empty states, voice vs tone, i18n |
147
-
148
- ## Extended Knowledge (Original)
149
-
150
- | Topic | Document | Covers |
151
- |-------|----------|--------|
152
- | UI Aesthetics | [ui-aesthetics.md](ui-aesthetics.md) | HSL color tokens, 8px grid CSS snippets, shadow scales, dark mode CSS |
153
- | Component Patterns | [component-patterns.md](component-patterns.md) | CSS Grid/Flexbox layouts, responsive nav, glass card, Framer Motion |
154
- | UX Principles | [ux-principles.md](ux-principles.md) | Nielsen 10 heuristics, WCAG, ARIA, keyboard, loading patterns |
155
- | State Management | [state-management.md](state-management.md) | Redux/Zustand/Jotai/Recoil/Context — decision tree + code templates |
156
- | Frontend Engineering | [engineering.md](engineering.md) | Web Vitals, code splitting, virtual scroll, Vitest/Playwright, Vite/Webpack |
157
-
158
- ## Design Style Systems
159
-
160
- Specific style variant specs with CSS tokens and component patterns:
161
-
162
- | Style | Document | Aesthetic |
163
- |-------|----------|-----------|
164
- | Claymorphism | [claymorphism/SKILL.md](claymorphism/SKILL.md) | Soft clay, large radii, dual inner shadows, offset outer shadows |
165
- | Glassmorphism | [glassmorphism/SKILL.md](glassmorphism/SKILL.md) | Frosted glass, backdrop-filter, translucency, blur layers |
166
- | Neubrutalism | [neubrutalism/SKILL.md](neubrutalism/SKILL.md) | Thick borders, offset solid shadows, high saturation, minimal radius |
167
- | Liquid Glass | [liquid-glass/SKILL.md](liquid-glass/SKILL.md) | Apple-style translucent depth, spring animations, ambient response |
168
-
169
- ---
170
-
171
- ## Command System (20 Impeccable Commands)
172
-
173
- All commands are in `~/.claude/skills/ccg/impeccable/`. Each invokes this skill's guidelines first.
174
-
175
- ### Quality & Audit
176
- | Command | What it does |
177
- |---------|------------|
178
- | `/audit` | Technical quality checks (a11y, performance, responsive, theming, anti-patterns) — scored 0-20 |
179
- | `/critique` | UX design review with Nielsen heuristics scoring (0-40), persona testing, cognitive load |
180
- | `/teach-impeccable` | One-time setup: gather design context, save to .impeccable.md |
181
-
182
- ### Fix & Align
183
- | Command | What it does |
184
- |---------|------------|
185
- | `/normalize` | Align with design system standards |
186
- | `/polish` | Final pass before shipping — 20-item checklist |
187
- | `/distill` | Strip to essence, remove unnecessary complexity |
188
- | `/clarify` | Improve unclear UX copy, error messages, labels |
189
- | `/optimize` | Performance improvements (CWV, bundle, rendering) |
190
- | `/harden` | Error handling, i18n, text overflow, edge cases |
191
-
192
- ### Style & Expression
193
- | Command | What it does |
194
- |---------|------------|
195
- | `/animate` | Add purposeful motion and micro-interactions |
196
- | `/colorize` | Introduce strategic color to monochromatic designs |
197
- | `/bolder` | Amplify boring designs with distinctive impact |
198
- | `/quieter` | Tone down overly bold designs to refined sophistication |
199
- | `/delight` | Add moments of joy, personality, and surprise |
200
-
201
- ### Structure & Components
202
- | Command | What it does |
203
- |---------|------------|
204
- | `/extract` | Pull into reusable components and design tokens |
205
- | `/adapt` | Adapt for different devices and contexts |
206
- | `/onboard` | Design onboarding flows and empty states |
207
- | `/typeset` | Fix font choices, hierarchy, sizing, readability |
208
- | `/arrange` | Fix layout, spacing, visual rhythm |
209
- | `/overdrive` | Technically extraordinary effects (shaders, springs, scroll-driven) |
210
-
211
- ### Combining Commands
212
- ```
213
- /audit /normalize /polish blog # Full workflow: audit -> fix -> polish
214
- /critique /harden checkout # UX review + add error handling
215
- /audit # Find issues first
216
- /normalize # Then fix inconsistencies
217
- /polish # Final cleanup
218
- ```
219
-
220
- ---
221
-
222
- ## Implementation Principles
223
-
224
- Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details.
225
-
226
- Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices across generations.
227
-
228
- ---
229
-
230
- ## Use Cases
231
-
232
- - Design system establishment
233
- - Component library development
234
- - UI/UX audit and review (`/audit`, `/critique`)
235
- - Accessibility improvement
236
- - Responsive layout design (`/adapt`)
237
- - Interaction and animation design (`/animate`, `/delight`)
238
- - Style variant selection (Claymorphism / Glassmorphism / Neubrutalism / Liquid Glass)
239
- - Performance optimization (`/optimize`)
240
- - Pre-launch polish (`/polish`)
241
- - Copy improvement (`/clarify`)
242
- - Production hardening (`/harden`)
243
- - Typography refinement (`/typeset`)
244
- - Layout improvement (`/arrange`)
1
+ ---
2
+ name: frontend-design
3
+ description: "前端设计秘典(Impeccable 融合版:排版/OKLCH 配色/空间/动效/交互/响应式/UX 文案 + 4 种 style 变体)。"
4
+ license: "Apache 2.0 (Impeccable) + MIT (custom extensions)"
5
+ user-invocable: false
6
+ disable-model-invocation: false
7
+ context: fork
8
+ paths: "*.tsx,*.jsx,*.vue,*.svelte,*.css,*.scss"
9
+ ---
10
+
11
+ # Frontend Design (Impeccable Fusion Edition)
12
+
13
+ This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. It fuses [Impeccable](https://github.com/pbakaus/impeccable) design philosophy with extended knowledge on state management, engineering, and design style systems.
14
+
15
+ ---
16
+
17
+ ## Context Gathering Protocol
18
+
19
+ Design skills produce generic output without project context. You MUST have confirmed design context before doing any design work.
20
+
21
+ **Required context** — every design skill needs at minimum:
22
+ - **Target audience**: Who uses this product and in what context?
23
+ - **Use cases**: What jobs are they trying to get done?
24
+ - **Brand personality/tone**: How should the interface feel?
25
+
26
+ **Gathering order:**
27
+ 1. **Check current instructions (instant)**: If your loaded instructions already contain a **Design Context** section, proceed immediately.
28
+ 2. **Check .impeccable.md (fast)**: If not in instructions, read `.impeccable.md` from the project root. If it exists and contains the required context, proceed.
29
+ 3. **Run /teach-impeccable (REQUIRED)**: If neither source has context, you MUST run `/teach-impeccable` NOW before doing anything else. Do NOT skip this step. Do NOT attempt to infer context from the codebase instead.
30
+
31
+ ---
32
+
33
+ ## Design Direction
34
+
35
+ Commit to a BOLD aesthetic direction:
36
+ - **Purpose**: What problem does this interface solve? Who uses it?
37
+ - **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc.
38
+ - **Constraints**: Technical requirements (framework, performance, accessibility).
39
+ - **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
40
+
41
+ **CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work — the key is intentionality, not intensity.
42
+
43
+ ---
44
+
45
+ ## Frontend Aesthetics Guidelines
46
+
47
+ ### Typography
48
+ > *Consult [typography reference](reference/typography.md) for scales, pairing, and loading strategies.*
49
+
50
+ Choose fonts that are beautiful, unique, and interesting. Pair a distinctive display font with a refined body font.
51
+
52
+ **DO**: Use a modular type scale with fluid sizing (clamp) for display text; fixed rem scales for app UIs
53
+ **DO**: Vary font weights and sizes to create clear visual hierarchy
54
+ **DON'T**: Use overused fonts — Inter, Roboto, Arial, Open Sans, system defaults
55
+ **DON'T**: Use monospace typography as lazy shorthand for "technical/developer" vibes
56
+ **DON'T**: Put large icons with rounded corners above every heading — they rarely add value
57
+
58
+ ### Color & Theme
59
+ > *Consult [color reference](reference/color-and-contrast.md) for OKLCH, palettes, and dark mode.*
60
+
61
+ Commit to a cohesive palette. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.
62
+
63
+ **DO**: Use OKLCH (not HSL) for perceptually uniform, maintainable palettes
64
+ **DO**: Tint your neutrals toward your brand hue — even a subtle hint creates subconscious cohesion
65
+ **DON'T**: Use gray text on colored backgrounds — use a shade of the background color instead
66
+ **DON'T**: Use pure black (#000) or pure white (#fff) — always tint
67
+ **DON'T**: Use the AI color palette: cyan-on-dark, purple-to-blue gradients, neon accents on dark backgrounds
68
+ **DON'T**: Use gradient text for "impact" — it's decorative rather than meaningful
69
+ **DON'T**: Default to dark mode with glowing accents
70
+
71
+ ### Layout & Space
72
+ > *Consult [spatial reference](reference/spatial-design.md) for grids, rhythm, and container queries.*
73
+
74
+ **DO**: Create visual rhythm through varied spacing — tight groupings, generous separations
75
+ **DO**: Use fluid spacing with clamp() that breathes on larger screens
76
+ **DO**: Use asymmetry and unexpected compositions; break the grid intentionally
77
+ **DON'T**: Wrap everything in cards — not everything needs a container
78
+ **DON'T**: Nest cards inside cards — flatten the hierarchy
79
+ **DON'T**: Use identical card grids — same-sized cards with icon + heading + text, repeated endlessly
80
+ **DON'T**: Center everything — left-aligned text with asymmetric layouts feels more designed
81
+ **DON'T**: Use the same spacing everywhere — without rhythm, layouts feel monotonous
82
+
83
+ ### Visual Details
84
+ **DO**: Use intentional, purposeful decorative elements that reinforce brand
85
+ **DON'T**: Use glassmorphism everywhere — blur effects used decoratively rather than purposefully
86
+ **DON'T**: Use rounded elements with thick colored border on one side — a lazy accent
87
+ **DON'T**: Use sparklines as decoration — tiny charts that convey nothing meaningful
88
+ **DON'T**: Use rounded rectangles with generic drop shadows — safe, forgettable
89
+ **DON'T**: Use modals unless there's truly no better alternative
90
+
91
+ ### Motion
92
+ > *Consult [motion reference](reference/motion-design.md) for timing, easing, and reduced motion.*
93
+
94
+ **DO**: Use motion to convey state changes — entrances, exits, feedback
95
+ **DO**: Use exponential easing (ease-out-quart/quint/expo) for natural deceleration
96
+ **DO**: For height animations, use grid-template-rows transitions
97
+ **DON'T**: Animate layout properties (width, height, padding, margin) — use transform and opacity only
98
+ **DON'T**: Use bounce or elastic easing — they feel dated and tacky
99
+
100
+ ### Interaction
101
+ > *Consult [interaction reference](reference/interaction-design.md) for forms, focus, and loading patterns.*
102
+
103
+ **DO**: Use progressive disclosure — start simple, reveal sophistication through interaction
104
+ **DO**: Design empty states that teach the interface, not just say "nothing here"
105
+ **DO**: Make every interactive surface feel intentional and responsive
106
+ **DON'T**: Repeat the same information — redundant headers, intros that restate the heading
107
+ **DON'T**: Make every button primary — hierarchy matters
108
+
109
+ ### Responsive
110
+ > *Consult [responsive reference](reference/responsive-design.md) for mobile-first, fluid design, and container queries.*
111
+
112
+ **DO**: Use container queries (@container) for component-level responsiveness
113
+ **DO**: Adapt the interface for different contexts — don't just shrink it
114
+ **DON'T**: Hide critical functionality on mobile — adapt, don't amputate
115
+
116
+ ### UX Writing
117
+ > *Consult [ux-writing reference](reference/ux-writing.md) for labels, errors, and empty states.*
118
+
119
+ **DO**: Make every word earn its place
120
+ **DON'T**: Repeat information users can already see
121
+
122
+ ---
123
+
124
+ ## The AI Slop Test
125
+
126
+ **Critical quality check**: If you showed this interface to someone and said "AI made this," would they believe you immediately? If yes, that's the problem.
127
+
128
+ A distinctive interface should make someone ask "how was this made?" not "which AI made this?"
129
+
130
+ Review the DON'T guidelines above — they are the fingerprints of AI-generated work from 2024-2025.
131
+
132
+ ---
133
+
134
+ ## Reference Library (Impeccable)
135
+
136
+ Deep-dive reference documents for each design dimension:
137
+
138
+ | Reference | Covers |
139
+ |-----------|--------|
140
+ | [typography](reference/typography.md) | Type systems, font pairing, modular scales, OpenType, web font loading |
141
+ | [color-and-contrast](reference/color-and-contrast.md) | OKLCH, tinted neutrals, dark mode, accessibility, 60-30-10 |
142
+ | [spatial-design](reference/spatial-design.md) | 4pt spacing, grids, visual hierarchy, container queries, optical adjustments |
143
+ | [motion-design](reference/motion-design.md) | 100/300/500 rule, easing curves, stagger, reduced motion, perceived performance |
144
+ | [interaction-design](reference/interaction-design.md) | 8 states, focus rings, Popover API, CSS Anchor, modals, keyboard nav |
145
+ | [responsive-design](reference/responsive-design.md) | Content-driven breakpoints, pointer/hover queries, safe areas, srcset |
146
+ | [ux-writing](reference/ux-writing.md) | Button labels, error formulas, empty states, voice vs tone, i18n |
147
+
148
+ ## Extended Knowledge (Original)
149
+
150
+ | Topic | Document | Covers |
151
+ |-------|----------|--------|
152
+ | UI Aesthetics | [ui-aesthetics.md](ui-aesthetics.md) | HSL color tokens, 8px grid CSS snippets, shadow scales, dark mode CSS |
153
+ | Component Patterns | [component-patterns.md](component-patterns.md) | CSS Grid/Flexbox layouts, responsive nav, glass card, Framer Motion |
154
+ | UX Principles | [ux-principles.md](ux-principles.md) | Nielsen 10 heuristics, WCAG, ARIA, keyboard, loading patterns |
155
+ | State Management | [state-management.md](state-management.md) | Redux/Zustand/Jotai/Recoil/Context — decision tree + code templates |
156
+ | Frontend Engineering | [engineering.md](engineering.md) | Web Vitals, code splitting, virtual scroll, Vitest/Playwright, Vite/Webpack |
157
+
158
+ ## Design Style Systems
159
+
160
+ Specific style variant specs with CSS tokens and component patterns:
161
+
162
+ | Style | Document | Aesthetic |
163
+ |-------|----------|-----------|
164
+ | Claymorphism | [claymorphism/SKILL.md](claymorphism/SKILL.md) | Soft clay, large radii, dual inner shadows, offset outer shadows |
165
+ | Glassmorphism | [glassmorphism/SKILL.md](glassmorphism/SKILL.md) | Frosted glass, backdrop-filter, translucency, blur layers |
166
+ | Neubrutalism | [neubrutalism/SKILL.md](neubrutalism/SKILL.md) | Thick borders, offset solid shadows, high saturation, minimal radius |
167
+ | Liquid Glass | [liquid-glass/SKILL.md](liquid-glass/SKILL.md) | Apple-style translucent depth, spring animations, ambient response |
168
+
169
+ ---
170
+
171
+ ## Command System (20 Impeccable Commands)
172
+
173
+ All commands are in `~/.claude/skills/ccg/impeccable/`. Each invokes this skill's guidelines first.
174
+
175
+ ### Quality & Audit
176
+ | Command | What it does |
177
+ |---------|------------|
178
+ | `/audit` | Technical quality checks (a11y, performance, responsive, theming, anti-patterns) — scored 0-20 |
179
+ | `/critique` | UX design review with Nielsen heuristics scoring (0-40), persona testing, cognitive load |
180
+ | `/teach-impeccable` | One-time setup: gather design context, save to .impeccable.md |
181
+
182
+ ### Fix & Align
183
+ | Command | What it does |
184
+ |---------|------------|
185
+ | `/normalize` | Align with design system standards |
186
+ | `/polish` | Final pass before shipping — 20-item checklist |
187
+ | `/distill` | Strip to essence, remove unnecessary complexity |
188
+ | `/clarify` | Improve unclear UX copy, error messages, labels |
189
+ | `/optimize` | Performance improvements (CWV, bundle, rendering) |
190
+ | `/harden` | Error handling, i18n, text overflow, edge cases |
191
+
192
+ ### Style & Expression
193
+ | Command | What it does |
194
+ |---------|------------|
195
+ | `/animate` | Add purposeful motion and micro-interactions |
196
+ | `/colorize` | Introduce strategic color to monochromatic designs |
197
+ | `/bolder` | Amplify boring designs with distinctive impact |
198
+ | `/quieter` | Tone down overly bold designs to refined sophistication |
199
+ | `/delight` | Add moments of joy, personality, and surprise |
200
+
201
+ ### Structure & Components
202
+ | Command | What it does |
203
+ |---------|------------|
204
+ | `/extract` | Pull into reusable components and design tokens |
205
+ | `/adapt` | Adapt for different devices and contexts |
206
+ | `/onboard` | Design onboarding flows and empty states |
207
+ | `/typeset` | Fix font choices, hierarchy, sizing, readability |
208
+ | `/arrange` | Fix layout, spacing, visual rhythm |
209
+ | `/overdrive` | Technically extraordinary effects (shaders, springs, scroll-driven) |
210
+
211
+ ### Combining Commands
212
+ ```
213
+ /audit /normalize /polish blog # Full workflow: audit -> fix -> polish
214
+ /critique /harden checkout # UX review + add error handling
215
+ /audit # Find issues first
216
+ /normalize # Then fix inconsistencies
217
+ /polish # Final cleanup
218
+ ```
219
+
220
+ ---
221
+
222
+ ## Implementation Principles
223
+
224
+ Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details.
225
+
226
+ Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices across generations.
227
+
228
+ ---
229
+
230
+ ## Use Cases
231
+
232
+ - Design system establishment
233
+ - Component library development
234
+ - UI/UX audit and review (`/audit`, `/critique`)
235
+ - Accessibility improvement
236
+ - Responsive layout design (`/adapt`)
237
+ - Interaction and animation design (`/animate`, `/delight`)
238
+ - Style variant selection (Claymorphism / Glassmorphism / Neubrutalism / Liquid Glass)
239
+ - Performance optimization (`/optimize`)
240
+ - Pre-launch polish (`/polish`)
241
+ - Copy improvement (`/clarify`)
242
+ - Production hardening (`/harden`)
243
+ - Typography refinement (`/typeset`)
244
+ - Layout improvement (`/arrange`)