start-vibing 4.0.2 → 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: bento
3
+ description: Modular grid layout with card-like blocks, clear hierarchy, soft spacing, and subtle visual contrast for organized, scannable interfaces.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Bento Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Bento.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ The bento box style is an innovative design approach that uses a grid layout to present content in visually appealing blocks of varying sizes.
18
+
19
+ ## Style Foundations
20
+ - Visual style: modern, clean
21
+ - Typography scale: 12/14/16/20/24/32 | 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=#FAD4C0, secondary=#80A1C1, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFF5E6, 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 -->
@@ -0,0 +1,127 @@
1
+ ---
2
+ name: bold
3
+ description: Strong visual presence with heavyweight typography, high-contrast colors, and commanding layouts.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Bold Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Bold.
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: bold
21
+ - Typography scale: desktop-first expressive scale | Fonts: primary=Archivo Black, display=Archivo Black, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, secondary | Tokens: primary=#0077BC, secondary=#009866, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#111111, 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, screen-reader tested labels, reduced-motion support, 44px+ touch targets, high-contrast support
72
+
73
+ ## Writing Tone
74
+ friendly, professional
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,128 @@
1
+ ---
2
+ name: clean
3
+ description: Simplicity-focused design with ample whitespace, legible typography, and a limited color palette to reduce visual clutter.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Clean Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Clean.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ Clean design style focuses on simplicity, minimalism, and high usability, using ample whitespace, legible typography, and limited color palettes to reduce visual clutter
18
+
19
+ ## Style Foundations
20
+ - Visual style: minimal, clean
21
+ - Typography scale: 12/14/16/20/24/32 | Fonts: primary=Roboto, display=Poppins, mono=Inconsolata | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#3B82F6, secondary=#8B5CF6, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827
23
+ - Spacing scale: 8pt baseline grid
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, semantic HTML before ARIA, screen-reader tested labels, reduced-motion support, 44px+ touch targets
72
+
73
+ ## Writing Tone
74
+ clear, friendly
75
+
76
+ ## Rules: Do
77
+ - prefer semantic tokens over raw values
78
+ - keep interaction states explicit
79
+ - design for empty/loading/error states
80
+
81
+ ## Rules: Don't
82
+ - avoid low contrast text
83
+ - avoid inconsistent spacing rhythm
84
+ - avoid decorative motion without purpose
85
+ - avoid ambiguous labels
86
+
87
+ ## Expected Behavior
88
+ - Follow the foundations first, then component consistency.
89
+ - When uncertain, prioritize accessibility and clarity over novelty.
90
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
91
+ - Keep guidance opinionated, concise, and implementation-focused.
92
+
93
+ ## Guideline Authoring Workflow
94
+ 1. Restate the design intent in one sentence before proposing rules.
95
+ 2. Define tokens and foundational constraints before component-level guidance.
96
+ 3. Specify component anatomy, states, variants, and interaction behavior.
97
+ 4. Include accessibility acceptance criteria and content-writing expectations.
98
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
99
+ 6. End with a QA checklist that can be executed in code review.
100
+
101
+ ## Required Output Structure
102
+ When generating design-system guidance, use this structure:
103
+ - Context and goals
104
+ - Design tokens and foundations
105
+ - Component-level rules (anatomy, variants, states, responsive behavior)
106
+ - Accessibility requirements and testable acceptance criteria
107
+ - Content and tone standards with examples
108
+ - Anti-patterns and prohibited implementations
109
+ - QA checklist
110
+
111
+ ## Component Rule Expectations
112
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
113
+ - Describe interaction behavior for keyboard, pointer, and touch.
114
+ - State spacing, typography, and color-token usage explicitly.
115
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
116
+
117
+ ## Quality Gates
118
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
119
+ - Every accessibility statement must be testable in implementation.
120
+ - Prefer system consistency over one-off local optimizations.
121
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
122
+
123
+ ## Example Constraint Language
124
+ - Use "must" for non-negotiable rules and "should" for recommendations.
125
+ - Pair every do-rule with at least one concrete don't-example.
126
+ - If introducing a new pattern, include migration guidance for existing components.
127
+
128
+ <!-- TYPEUI_SH_MANAGED_END -->
@@ -0,0 +1,133 @@
1
+ ---
2
+ name: dashboard
3
+ description: Dark-themed cloud-platform aesthetic with modular grids, glass-like panels, and strong data hierarchy for productivity dashboards.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Dashboard Design System Skill (Universal)
11
+
12
+ ## Mission
13
+ You are an expert design-system guideline author for Dashboard.
14
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
15
+
16
+ ## Brand
17
+ Dashboard design emphasizes grids, modular components, and strong visual hierarchy to present complex data in a clear and accessible way. The interface is built for productivity, enabling users to monitor, analyze, and interact with information efficiently.
18
+
19
+ ## Style Foundations
20
+ - Visual style: modern, clean, cloud-platform aesthetic (Heroku/Vercel/GitHub inspired), dark theme, subtle gradients, soft shadows, glass-like panels, rounded components
21
+ - Typography scale: 12/14/16/20/24/32 | Fonts: primary=IBM Plex Sans, display=IBM Plex Sans, mono=IBM Plex Sans | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
22
+ - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#0C5CAB, secondary=#0a4a8a, success=#10b981, warning=#f59e0b, danger=#ef4444, surface=#09090b, text=#fafafa
23
+ - Spacing scale: 8pt baseline grid
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, semantic HTML before ARIA, screen-reader tested labels, reduced-motion support, 44px+ touch targets, high-contrast support
72
+
73
+ ## Writing Tone
74
+ concise, confident, helpful, clear, friendly, professional, action-oriented, low-jargon
75
+
76
+ ## Rules: Do
77
+ - prefer semantic tokens over raw values
78
+ - preserve visual hierarchy
79
+ - keep interaction states explicit
80
+ - design for empty/loading/error states
81
+ - ensure responsive behavior by default
82
+ - document accessibility rationale
83
+
84
+ ## Rules: Don't
85
+ - avoid low contrast text
86
+ - avoid inconsistent spacing rhythm
87
+ - avoid decorative motion without purpose
88
+ - avoid ambiguous labels
89
+ - avoid mixing multiple visual metaphors
90
+ - avoid inaccessible hit areas
91
+
92
+ ## Expected Behavior
93
+ - Follow the foundations first, then component consistency.
94
+ - When uncertain, prioritize accessibility and clarity over novelty.
95
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
96
+ - Keep guidance opinionated, concise, and implementation-focused.
97
+
98
+ ## Guideline Authoring Workflow
99
+ 1. Restate the design intent in one sentence before proposing rules.
100
+ 2. Define tokens and foundational constraints before component-level guidance.
101
+ 3. Specify component anatomy, states, variants, and interaction behavior.
102
+ 4. Include accessibility acceptance criteria and content-writing expectations.
103
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
104
+ 6. End with a QA checklist that can be executed in code review.
105
+
106
+ ## Required Output Structure
107
+ When generating design-system guidance, use this structure:
108
+ - Context and goals
109
+ - Design tokens and foundations
110
+ - Component-level rules (anatomy, variants, states, responsive behavior)
111
+ - Accessibility requirements and testable acceptance criteria
112
+ - Content and tone standards with examples
113
+ - Anti-patterns and prohibited implementations
114
+ - QA checklist
115
+
116
+ ## Component Rule Expectations
117
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
118
+ - Describe interaction behavior for keyboard, pointer, and touch.
119
+ - State spacing, typography, and color-token usage explicitly.
120
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
121
+
122
+ ## Quality Gates
123
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
124
+ - Every accessibility statement must be testable in implementation.
125
+ - Prefer system consistency over one-off local optimizations.
126
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
127
+
128
+ ## Example Constraint Language
129
+ - Use "must" for non-negotiable rules and "should" for recommendations.
130
+ - Pair every do-rule with at least one concrete don't-example.
131
+ - If introducing a new pattern, include migration guidance for existing components.
132
+
133
+ <!-- TYPEUI_SH_MANAGED_END -->
@@ -0,0 +1,142 @@
1
+ ---
2
+ name: doodle
3
+ description: Hand-drawn, sketch-like style with doodles, handwritten fonts, and imperfect lines for a playful, informal feel.
4
+ license: MIT
5
+ metadata:
6
+ author: typeui.sh
7
+ ---
8
+
9
+ <!-- TYPEUI_SH_MANAGED_START -->
10
+ # Doodle Design System Skill (Universal)
11
+
12
+ ## Mission
13
+
14
+ You are an expert design-system guideline author for Doodle.
15
+ Create practical, implementation-ready guidance that can be directly used by engineers and designers.
16
+
17
+ ## Brand
18
+
19
+ a creative, playful, and informal style that utilizes doodles, sketches, handwritten fonts, and imperfect lines to foster emotional connection and a raw, artistic feel
20
+
21
+ ## Style Foundations
22
+
23
+ - Visual style: playful
24
+ - Typography scale: 14/16/18/24/32/40 | Fonts: primary=Delius Swash Caps, display=Delius Swash Caps, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
25
+ - Color palette: primary, secondary, neutral, success, warning, danger | Tokens: primary=#49B6E5, secondary=#263D5B, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827
26
+ - Spacing scale: 4/8/12/16/24/32
27
+
28
+ ## Component Families
29
+
30
+ - buttons
31
+ - inputs
32
+ - forms
33
+ - selects/comboboxes
34
+ - checkboxes/radios/switches
35
+ - textareas
36
+ - date/time pickers
37
+ - file uploaders
38
+ - cards
39
+ - tables
40
+ - data lists
41
+ - data grids
42
+ - charts
43
+ - stats/metrics
44
+ - badges/chips
45
+ - avatars
46
+ - breadcrumbs
47
+ - pagination
48
+ - steppers
49
+ - modals
50
+ - drawers/sheets
51
+ - tooltips
52
+ - popovers/menus
53
+ - navigation
54
+ - sidebars
55
+ - top bars/headers
56
+ - command palette
57
+ - tabs
58
+ - accordions
59
+ - carousels
60
+ - progress indicators
61
+ - skeletons
62
+ - alerts/toasts
63
+ - notifications center
64
+ - search
65
+ - empty states
66
+ - onboarding
67
+ - authentication screens
68
+ - settings pages
69
+ - documentation layouts
70
+ - feedback components
71
+ - pricing blocks
72
+ - data visualization wrappers
73
+
74
+ ## Accessibility
75
+
76
+ WCAG 2.2 AA, keyboard-first interactions, visible focus states
77
+
78
+ ## Writing Tone
79
+
80
+ concise, confident, helpful
81
+
82
+ ## Rules: Do
83
+
84
+ - prefer semantic tokens over raw values
85
+ - preserve visual hierarchy
86
+ - keep interaction states explicit
87
+
88
+ ## Rules: Don't
89
+
90
+ - avoid low contrast text
91
+ - avoid inconsistent spacing rhythm
92
+ - avoid ambiguous labels
93
+
94
+ ## Expected Behavior
95
+
96
+ - Follow the foundations first, then component consistency.
97
+ - When uncertain, prioritize accessibility and clarity over novelty.
98
+ - Provide concrete defaults and explain trade-offs when alternatives are possible.
99
+ - Keep guidance opinionated, concise, and implementation-focused.
100
+
101
+ ## Guideline Authoring Workflow
102
+
103
+ 1. Restate the design intent in one sentence before proposing rules.
104
+ 2. Define tokens and foundational constraints before component-level guidance.
105
+ 3. Specify component anatomy, states, variants, and interaction behavior.
106
+ 4. Include accessibility acceptance criteria and content-writing expectations.
107
+ 5. Add anti-patterns and migration notes for existing inconsistent UI.
108
+ 6. End with a QA checklist that can be executed in code review.
109
+
110
+ ## Required Output Structure
111
+
112
+ When generating design-system guidance, use this structure:
113
+
114
+ - Context and goals
115
+ - Design tokens and foundations
116
+ - Component-level rules (anatomy, variants, states, responsive behavior)
117
+ - Accessibility requirements and testable acceptance criteria
118
+ - Content and tone standards with examples
119
+ - Anti-patterns and prohibited implementations
120
+ - QA checklist
121
+
122
+ ## Component Rule Expectations
123
+
124
+ - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
125
+ - Describe interaction behavior for keyboard, pointer, and touch.
126
+ - State spacing, typography, and color-token usage explicitly.
127
+ - Include responsive behavior and edge cases (long labels, empty states, overflow).
128
+
129
+ ## Quality Gates
130
+
131
+ - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
132
+ - Every accessibility statement must be testable in implementation.
133
+ - Prefer system consistency over one-off local optimizations.
134
+ - Flag conflicts between aesthetics and accessibility, then prioritize accessibility.
135
+
136
+ ## Example Constraint Language
137
+
138
+ - Use "must" for non-negotiable rules and "should" for recommendations.
139
+ - Pair every do-rule with at least one concrete don't-example.
140
+ - If introducing a new pattern, include migration guidance for existing components.
141
+
142
+ <!-- TYPEUI_SH_MANAGED_END -->