start-vibing 4.1.0 → 4.1.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 (67) hide show
  1. package/package.json +1 -1
  2. package/template/.claude/CLAUDE.md +86 -20
  3. package/template/.claude/agents/sd-audit.md +197 -0
  4. package/template/.claude/agents/sd-fix-verify-semantic.md +112 -0
  5. package/template/.claude/agents/sd-fix-verify-technical.md +36 -0
  6. package/template/.claude/agents/sd-fix.md +194 -0
  7. package/template/.claude/agents/sd-research.md +61 -0
  8. package/template/.claude/agents/sd-synthesis.md +74 -0
  9. package/template/.claude/commands/super-design.md +15 -0
  10. package/template/.claude/hooks/super-design-session-start.sh +4 -0
  11. package/template/.claude/settings.json +14 -0
  12. package/template/.claude/skills/codebase-knowledge/SKILL.md +145 -0
  13. package/template/.claude/skills/codebase-knowledge/TEMPLATE.md +35 -0
  14. package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +93 -0
  15. package/template/.claude/skills/composition-patterns/SKILL.md +89 -0
  16. package/template/.claude/skills/docs-tracker/SKILL.md +239 -0
  17. package/template/.claude/skills/mcp-builder/SKILL.md +236 -0
  18. package/template/.claude/skills/quality-gate/scripts/check-all.sh +83 -0
  19. package/template/.claude/skills/react-best-practices/SKILL.md +146 -0
  20. package/template/.claude/skills/security-scan/reference/owasp-top-10.md +257 -0
  21. package/template/.claude/skills/security-scan/scripts/scan.py +190 -0
  22. package/template/.claude/skills/super-design/README.md +37 -0
  23. package/template/.claude/skills/super-design/SKILL.md +105 -0
  24. package/template/.claude/skills/super-design/hooks/guard-paths.py +35 -0
  25. package/template/.claude/skills/super-design/hooks/post-edit-lint.py +57 -0
  26. package/template/.claude/skills/super-design/references/audit-methodology.md +513 -0
  27. package/template/.claude/skills/super-design/references/change-detection-playbook.md +1432 -0
  28. package/template/.claude/skills/super-design/references/design-theory.md +706 -0
  29. package/template/.claude/skills/super-design/references/fix-agent-playbook.md +118 -0
  30. package/template/.claude/skills/super-design/references/market-research-playbook.md +773 -0
  31. package/template/.claude/skills/super-design/references/playwright-mcp-reference.md +1057 -0
  32. package/template/.claude/skills/super-design/references/skills-subagents-reference.md +784 -0
  33. package/template/.claude/skills/super-design/references/superpowers-and-distribution.md +136 -0
  34. package/template/.claude/skills/super-design/scripts/detect-changes.sh +61 -0
  35. package/template/.claude/skills/super-design/scripts/diff-tokens.sh +13 -0
  36. package/template/.claude/skills/super-design/scripts/discover-routes.sh +45 -0
  37. package/template/.claude/skills/super-design/scripts/extract-tokens.mjs +41 -0
  38. package/template/.claude/skills/super-design/scripts/hash-pages.sh +42 -0
  39. package/template/.claude/skills/super-design/scripts/validate-state.sh +15 -0
  40. package/template/.claude/skills/super-design/scripts/verify-audit.sh +19 -0
  41. package/template/.claude/skills/super-design/templates/audit-state.schema.json +57 -0
  42. package/template/.claude/skills/super-design/templates/findings.schema.json +57 -0
  43. package/template/.claude/skills/super-design/templates/fix-history.md.tpl +26 -0
  44. package/template/.claude/skills/super-design/templates/overview.md.tpl +52 -0
  45. package/template/.claude/skills/test-coverage/reference/playwright-patterns.md +260 -0
  46. package/template/.claude/skills/test-coverage/scripts/coverage-check.sh +52 -0
  47. package/template/.claude/skills/typeui-ant/SKILL.md +133 -0
  48. package/template/.claude/skills/typeui-application/SKILL.md +128 -0
  49. package/template/.claude/skills/typeui-artistic/SKILL.md +133 -0
  50. package/template/.claude/skills/typeui-bento/SKILL.md +127 -0
  51. package/template/.claude/skills/typeui-bold/SKILL.md +127 -0
  52. package/template/.claude/skills/typeui-clean/SKILL.md +128 -0
  53. package/template/.claude/skills/typeui-dashboard/SKILL.md +133 -0
  54. package/template/.claude/skills/typeui-doodle/SKILL.md +142 -0
  55. package/template/.claude/skills/typeui-dramatic/SKILL.md +127 -0
  56. package/template/.claude/skills/typeui-enterprise/SKILL.md +132 -0
  57. package/template/.claude/skills/typeui-neobrutalism/SKILL.md +127 -0
  58. package/template/.claude/skills/typeui-paper/SKILL.md +127 -0
  59. package/template/.claude/skills/ui-ux-audit/QUICK-START.md +450 -0
  60. package/template/.claude/skills/ui-ux-audit/README.md +470 -0
  61. package/template/.claude/skills/ui-ux-audit/templates/audit-report.md +591 -0
  62. package/template/.claude/skills/ui-ux-audit/templates/competitor-analysis.md +363 -0
  63. package/template/.claude/skills/ui-ux-audit/templates/component-spec.md +491 -0
  64. package/template/.claude/skills/ui-ux-audit/templates/improvement-recommendation.md +450 -0
  65. package/template/.claude/skills/web-design-guidelines/SKILL.md +39 -0
  66. package/template/.claude/skills/webapp-testing/SKILL.md +96 -0
  67. package/template/.claude/skills/workflow-state/workflow-state.json +77 -0
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: dramatic
3
+ description: High-contrast, theatrical design with bold layouts, immersive visuals, and unconventional compositions that command attention.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Dramatic Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Dramatic.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ Dramatic design style is a trend characterized by high-contrast visuals, bold, unconventional layouts, and immersive, theatrical experiences designed to grab user attention.
18
+
19
+ ## Style Foundations
20
+ - Visual style: modern, clean, high-contrast
21
+ - Typography scale: 12/14/16/20/24/32 | Fonts: primary=Outfit, display=Outfit, mono=JetBrains Mono | weights=400, 900
22
+ - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#8B5CF6, secondary=#F43F5E, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#09090B, text=#FAFAFA
23
+ - Spacing scale: 4/8/12/16/24/32
24
+
25
+ ## Component Families
26
+ - buttons
27
+ - inputs
28
+ - forms
29
+ - selects/comboboxes
30
+ - checkboxes/radios/switches
31
+ - textareas
32
+ - date/time pickers
33
+ - file uploaders
34
+ - cards
35
+ - tables
36
+ - data lists
37
+ - data grids
38
+ - charts
39
+ - stats/metrics
40
+ - badges/chips
41
+ - avatars
42
+ - breadcrumbs
43
+ - pagination
44
+ - steppers
45
+ - modals
46
+ - drawers/sheets
47
+ - tooltips
48
+ - popovers/menus
49
+ - navigation
50
+ - sidebars
51
+ - top bars/headers
52
+ - command palette
53
+ - tabs
54
+ - accordions
55
+ - carousels
56
+ - progress indicators
57
+ - skeletons
58
+ - alerts/toasts
59
+ - notifications center
60
+ - search
61
+ - empty states
62
+ - onboarding
63
+ - authentication screens
64
+ - settings pages
65
+ - documentation layouts
66
+ - feedback components
67
+ - pricing blocks
68
+ - data visualization wrappers
69
+
70
+ ## Accessibility
71
+ WCAG 2.2 AA, keyboard-first interactions, visible focus states
72
+
73
+ ## Writing Tone
74
+ concise, confident, helpful
75
+
76
+ ## Rules: Do
77
+ - prefer semantic tokens over raw values
78
+ - preserve visual hierarchy
79
+ - keep interaction states explicit
80
+
81
+ ## Rules: Don't
82
+ - avoid low contrast text
83
+ - avoid inconsistent spacing rhythm
84
+ - avoid ambiguous labels
85
+
86
+ ## Expected Behavior
87
+ - Follow the foundations first, then component consistency.
88
+ - When uncertain, prioritize accessibility and clarity over novelty.
89
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
90
+ - Keep guidance opinionated, concise, and implementation-focused.
91
+
92
+ ## Guideline Authoring Workflow
93
+ 1. Restate the design intent in one sentence before proposing rules.
94
+ 2. Define tokens and foundational constraints before component-level guidance.
95
+ 3. Specify component anatomy, states, variants, and interaction behavior.
96
+ 4. Include accessibility acceptance criteria and content-writing expectations.
97
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
98
+ 6. End with a QA checklist that can be executed in code review.
99
+
100
+ ## Required Output Structure
101
+ When generating design-system guidance, use this structure:
102
+ - Context and goals
103
+ - Design tokens and foundations
104
+ - Component-level rules (anatomy, variants, states, responsive behavior)
105
+ - Accessibility requirements and testable acceptance criteria
106
+ - Content and tone standards with examples
107
+ - Anti-patterns and prohibited implementations
108
+ - QA checklist
109
+
110
+ ## Component Rule Expectations
111
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
112
+ - Describe interaction behavior for keyboard, pointer, and touch.
113
+ - State spacing, typography, and color-token usage explicitly.
114
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
115
+
116
+ ## Quality Gates
117
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
118
+ - Every accessibility statement must be testable in implementation.
119
+ - Prefer system consistency over one-off local optimizations.
120
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
121
+
122
+ ## Example Constraint Language
123
+ - Use "must" for non-negotiable rules and "should" for recommendations.
124
+ - Pair every do-rule with at least one concrete don't-example.
125
+ - If introducing a new pattern, include migration guidance for existing components.
126
+
127
+ <!-- TYPEUI_SH_MANAGED_END -->
@@ -0,0 +1,132 @@
1
+ ---
2
+ name: enterprise
3
+ description: Clean, high-contrast enterprise design for data-driven workflows with intuitive drag-and-drop patterns and structured layouts.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Enterprise Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Enterprise.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ Everything you need – data, apps, and AI in an intuitive drag and drop interface to automate your workflows.
18
+
19
+ ## Style Foundations
20
+ - Visual style: clean, high-contrast, enterprise
21
+ - Typography scale: desktop-first expressive scale | Fonts: primary=Ubuntu, display=Oswald, mono=Ubuntu Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, success, warning, danger | Tokens: primary=#072C2C, secondary=#FF5F03, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#EDEADE, text=#111827
23
+ - Spacing scale: comfortable density mode
24
+
25
+ ## Component Families
26
+ - buttons
27
+ - inputs
28
+ - forms
29
+ - selects/comboboxes
30
+ - checkboxes/radios/switches
31
+ - textareas
32
+ - date/time pickers
33
+ - file uploaders
34
+ - cards
35
+ - tables
36
+ - data lists
37
+ - data grids
38
+ - charts
39
+ - stats/metrics
40
+ - badges/chips
41
+ - avatars
42
+ - breadcrumbs
43
+ - pagination
44
+ - steppers
45
+ - modals
46
+ - drawers/sheets
47
+ - tooltips
48
+ - popovers/menus
49
+ - navigation
50
+ - sidebars
51
+ - top bars/headers
52
+ - command palette
53
+ - tabs
54
+ - accordions
55
+ - carousels
56
+ - progress indicators
57
+ - skeletons
58
+ - alerts/toasts
59
+ - notifications center
60
+ - search
61
+ - empty states
62
+ - onboarding
63
+ - authentication screens
64
+ - settings pages
65
+ - documentation layouts
66
+ - feedback components
67
+ - pricing blocks
68
+ - data visualization wrappers
69
+ - patterns
70
+ - images
71
+
72
+ ## Accessibility
73
+ WCAG 2.2 AA, keyboard-first interactions, visible focus states
74
+
75
+ ## Writing Tone
76
+ confident, helpful, friendly, professional
77
+
78
+ ## Rules: Do
79
+ - prefer semantic tokens over raw values
80
+ - preserve visual hierarchy
81
+ - keep interaction states explicit
82
+
83
+ ## Rules: Don't
84
+ - avoid low contrast text
85
+ - avoid inconsistent spacing rhythm
86
+ - avoid decorative motion without purpose
87
+ - avoid ambiguous labels
88
+ - avoid mixing multiple visual metaphors
89
+ - avoid inaccessible hit areas
90
+
91
+ ## Expected Behavior
92
+ - Follow the foundations first, then component consistency.
93
+ - When uncertain, prioritize accessibility and clarity over novelty.
94
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
95
+ - Keep guidance opinionated, concise, and implementation-focused.
96
+
97
+ ## Guideline Authoring Workflow
98
+ 1. Restate the design intent in one sentence before proposing rules.
99
+ 2. Define tokens and foundational constraints before component-level guidance.
100
+ 3. Specify component anatomy, states, variants, and interaction behavior.
101
+ 4. Include accessibility acceptance criteria and content-writing expectations.
102
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
103
+ 6. End with a QA checklist that can be executed in code review.
104
+
105
+ ## Required Output Structure
106
+ When generating design-system guidance, use this structure:
107
+ - Context and goals
108
+ - Design tokens and foundations
109
+ - Component-level rules (anatomy, variants, states, responsive behavior)
110
+ - Accessibility requirements and testable acceptance criteria
111
+ - Content and tone standards with examples
112
+ - Anti-patterns and prohibited implementations
113
+ - QA checklist
114
+
115
+ ## Component Rule Expectations
116
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
117
+ - Describe interaction behavior for keyboard, pointer, and touch.
118
+ - State spacing, typography, and color-token usage explicitly.
119
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
120
+
121
+ ## Quality Gates
122
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
123
+ - Every accessibility statement must be testable in implementation.
124
+ - Prefer system consistency over one-off local optimizations.
125
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
126
+
127
+ ## Example Constraint Language
128
+ - Use "must" for non-negotiable rules and "should" for recommendations.
129
+ - Pair every do-rule with at least one concrete don't-example.
130
+ - If introducing a new pattern, include migration guidance for existing components.
131
+
132
+ <!-- TYPEUI_SH_MANAGED_END -->
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: neobrutalism
3
+ description: Modern take on brutalism with bold borders, vivid accent colors, and raw, high-contrast layouts on warm surfaces.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # neobrutalism Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for neobrutalism design.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+
18
+
19
+ ## Style Foundations
20
+ - Visual style: modern, clean, high-contrast
21
+ - Typography scale: 13/15/17/21/27/35 | Fonts: primary=Inter, display=Inter, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#FDC800, secondary=#432DD7, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FBFBF9, text=#1C293C
23
+ - Spacing scale: 4/8/12/16/24/32
24
+
25
+ ## Component Families
26
+ - buttons
27
+ - inputs
28
+ - forms
29
+ - selects/comboboxes
30
+ - checkboxes/radios/switches
31
+ - textareas
32
+ - date/time pickers
33
+ - file uploaders
34
+ - cards
35
+ - tables
36
+ - data lists
37
+ - data grids
38
+ - charts
39
+ - stats/metrics
40
+ - badges/chips
41
+ - avatars
42
+ - breadcrumbs
43
+ - pagination
44
+ - steppers
45
+ - modals
46
+ - drawers/sheets
47
+ - tooltips
48
+ - popovers/menus
49
+ - navigation
50
+ - sidebars
51
+ - top bars/headers
52
+ - command palette
53
+ - tabs
54
+ - accordions
55
+ - carousels
56
+ - progress indicators
57
+ - skeletons
58
+ - alerts/toasts
59
+ - notifications center
60
+ - search
61
+ - empty states
62
+ - onboarding
63
+ - authentication screens
64
+ - settings pages
65
+ - documentation layouts
66
+ - feedback components
67
+ - pricing blocks
68
+ - data visualization wrappers
69
+
70
+ ## Accessibility
71
+ WCAG 2.2 AA, keyboard-first interactions, visible focus states
72
+
73
+ ## Writing Tone
74
+ concise, confident, helpful
75
+
76
+ ## Rules: Do
77
+ - prefer semantic tokens over raw values
78
+ - preserve visual hierarchy
79
+ - keep interaction states explicit
80
+
81
+ ## Rules: Don't
82
+ - avoid low contrast text
83
+ - avoid inconsistent spacing rhythm
84
+ - avoid ambiguous labels
85
+
86
+ ## Expected Behavior
87
+ - Follow the foundations first, then component consistency.
88
+ - When uncertain, prioritize accessibility and clarity over novelty.
89
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
90
+ - Keep guidance opinionated, concise, and implementation-focused.
91
+
92
+ ## Guideline Authoring Workflow
93
+ 1. Restate the design intent in one sentence before proposing rules.
94
+ 2. Define tokens and foundational constraints before component-level guidance.
95
+ 3. Specify component anatomy, states, variants, and interaction behavior.
96
+ 4. Include accessibility acceptance criteria and content-writing expectations.
97
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
98
+ 6. End with a QA checklist that can be executed in code review.
99
+
100
+ ## Required Output Structure
101
+ When generating design-system guidance, use this structure:
102
+ - Context and goals
103
+ - Design tokens and foundations
104
+ - Component-level rules (anatomy, variants, states, responsive behavior)
105
+ - Accessibility requirements and testable acceptance criteria
106
+ - Content and tone standards with examples
107
+ - Anti-patterns and prohibited implementations
108
+ - QA checklist
109
+
110
+ ## Component Rule Expectations
111
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
112
+ - Describe interaction behavior for keyboard, pointer, and touch.
113
+ - State spacing, typography, and color-token usage explicitly.
114
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
115
+
116
+ ## Quality Gates
117
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
118
+ - Every accessibility statement must be testable in implementation.
119
+ - Prefer system consistency over one-off local optimizations.
120
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
121
+
122
+ ## Example Constraint Language
123
+ - Use "must" for non-negotiable rules and "should" for recommendations.
124
+ - Pair every do-rule with at least one concrete don't-example.
125
+ - If introducing a new pattern, include migration guidance for existing components.
126
+
127
+ <!-- TYPEUI_SH_MANAGED_END -->
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: paper
3
+ description: Paper-textured, print-inspired design with minimal colors, clean serif/sans typography, and tactile surface qualities.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Paper Design Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Paper Design.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ Paper design style
18
+
19
+ ## Style Foundations
20
+ - Visual style: minimal, clean
21
+ - Typography scale: 14/16/18/24/32/40 | Fonts: primary=Roboto, display=Montserrat, mono=PT Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#111111, secondary=#8B5CF6, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827
23
+ - Spacing scale: 4/8/12/16/24/32
24
+
25
+ ## Component Families
26
+ - buttons
27
+ - inputs
28
+ - forms
29
+ - selects/comboboxes
30
+ - checkboxes/radios/switches
31
+ - textareas
32
+ - date/time pickers
33
+ - file uploaders
34
+ - cards
35
+ - tables
36
+ - data lists
37
+ - data grids
38
+ - charts
39
+ - stats/metrics
40
+ - badges/chips
41
+ - avatars
42
+ - breadcrumbs
43
+ - pagination
44
+ - steppers
45
+ - modals
46
+ - drawers/sheets
47
+ - tooltips
48
+ - popovers/menus
49
+ - navigation
50
+ - sidebars
51
+ - top bars/headers
52
+ - command palette
53
+ - tabs
54
+ - accordions
55
+ - carousels
56
+ - progress indicators
57
+ - skeletons
58
+ - alerts/toasts
59
+ - notifications center
60
+ - search
61
+ - empty states
62
+ - onboarding
63
+ - authentication screens
64
+ - settings pages
65
+ - documentation layouts
66
+ - feedback components
67
+ - pricing blocks
68
+ - data visualization wrappers
69
+
70
+ ## Accessibility
71
+ WCAG 2.2 AA, keyboard-first interactions, visible focus states
72
+
73
+ ## Writing Tone
74
+ concise, confident, helpful
75
+
76
+ ## Rules: Do
77
+ - prefer semantic tokens over raw values
78
+ - preserve visual hierarchy
79
+ - keep interaction states explicit
80
+
81
+ ## Rules: Don't
82
+ - avoid low contrast text
83
+ - avoid inconsistent spacing rhythm
84
+ - avoid ambiguous labels
85
+
86
+ ## Expected Behavior
87
+ - Follow the foundations first, then component consistency.
88
+ - When uncertain, prioritize accessibility and clarity over novelty.
89
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
90
+ - Keep guidance opinionated, concise, and implementation-focused.
91
+
92
+ ## Guideline Authoring Workflow
93
+ 1. Restate the design intent in one sentence before proposing rules.
94
+ 2. Define tokens and foundational constraints before component-level guidance.
95
+ 3. Specify component anatomy, states, variants, and interaction behavior.
96
+ 4. Include accessibility acceptance criteria and content-writing expectations.
97
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
98
+ 6. End with a QA checklist that can be executed in code review.
99
+
100
+ ## Required Output Structure
101
+ When generating design-system guidance, use this structure:
102
+ - Context and goals
103
+ - Design tokens and foundations
104
+ - Component-level rules (anatomy, variants, states, responsive behavior)
105
+ - Accessibility requirements and testable acceptance criteria
106
+ - Content and tone standards with examples
107
+ - Anti-patterns and prohibited implementations
108
+ - QA checklist
109
+
110
+ ## Component Rule Expectations
111
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
112
+ - Describe interaction behavior for keyboard, pointer, and touch.
113
+ - State spacing, typography, and color-token usage explicitly.
114
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
115
+
116
+ ## Quality Gates
117
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
118
+ - Every accessibility statement must be testable in implementation.
119
+ - Prefer system consistency over one-off local optimizations.
120
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
121
+
122
+ ## Example Constraint Language
123
+ - Use "must" for non-negotiable rules and "should" for recommendations.
124
+ - Pair every do-rule with at least one concrete don't-example.
125
+ - If introducing a new pattern, include migration guidance for existing components.
126
+
127
+ <!-- TYPEUI_SH_MANAGED_END -->