Fix invalid YAML frontmatter and consolidate build transformers

Fixes #67: argument-hint values starting with [ were parsed as YAML flow
sequences. Replace structured args arrays in source files with pre-formatted
argument-hint strings, and quote values starting with [ or { in
generateYamlFrontmatter().

Also consolidates 8 nearly-identical transformer files into a single
config-driven createTransformer() factory. Adding a new provider now
requires only a config object in providers.js instead of a full file.

- Replace args source frontmatter with argument-hint strings
- Add YAML quoting for values starting with [ or {
- Add quote stripping to parseFrontmatter() for round-trip support
- Create factory.js + providers.js, delete 8 individual transformers
- Replace 16 explicit build.js calls with a loop over PROVIDERS
- Consolidate 8 test files into 2 (factory + providers)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Paul Bakaus
2026-03-24 09:48:42 -07:00
co-authored by Claude Opus 4.6
parent e9ac702849
commit 6de73abf1b
121 changed files with 904 additions and 7332 deletions
+1 -7
View File
@@ -2,13 +2,7 @@
name: adapt
description: Adapt designs to work across different screen sizes, devices, contexts, or platforms. Ensures consistent experience across varied environments.
user-invocable: true
args:
- name: target
description: The feature or component to adapt (optional)
required: false
- name: context
description: What to adapt for (mobile, tablet, desktop, print, email, etc.)
required: false
argument-hint: "[target] [context (mobile, tablet, print...)]"
---
Adapt existing designs to work effectively across different contexts - different screen sizes, devices, platforms, or use cases.
+1 -4
View File
@@ -2,10 +2,7 @@
name: animate
description: Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.
user-invocable: true
args:
- name: target
description: The feature or component to animate (optional)
required: false
argument-hint: "[target]"
---
Analyze a feature and strategically add animations and micro-interactions that enhance understanding, provide feedback, and create delight.
+1 -4
View File
@@ -2,10 +2,7 @@
name: arrange
description: Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy to create intentional compositions.
user-invocable: true
args:
- name: target
description: The feature or component to improve layout for (optional)
required: false
argument-hint: "[target]"
---
Assess and improve layout and spacing that feels monotonous, crowded, or structurally weak — turning generic arrangements into intentional, rhythmic compositions.
+1 -4
View File
@@ -2,10 +2,7 @@
name: audit
description: Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations.
user-invocable: true
args:
- name: area
description: The feature or area to audit (optional)
required: false
argument-hint: "[area (feature, page, component...)]"
---
Run systematic quality checks and generate a comprehensive audit report with prioritized issues and actionable recommendations. Don't fix issues - document them for other commands to address.
+1 -4
View File
@@ -2,10 +2,7 @@
name: bolder
description: Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability.
user-invocable: true
args:
- name: target
description: The feature or component to make bolder (optional)
required: false
argument-hint: "[target]"
---
Increase visual impact and personality in designs that are too safe, generic, or visually underwhelming, creating more engaging and memorable experiences.
+1 -4
View File
@@ -2,10 +2,7 @@
name: clarify
description: Improve unclear UX copy, error messages, microcopy, labels, and instructions. Makes interfaces easier to understand and use.
user-invocable: true
args:
- name: target
description: The feature or component with unclear copy (optional)
required: false
argument-hint: "[target]"
---
Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.
+1 -4
View File
@@ -2,10 +2,7 @@
name: colorize
description: Add strategic color to features that are too monochromatic or lack visual interest. Makes interfaces more engaging and expressive.
user-invocable: true
args:
- name: target
description: The feature or component to colorize (optional)
required: false
argument-hint: "[target]"
---
Strategically introduce color to designs that are too monochromatic, gray, or lacking in visual warmth and personality.
+1 -4
View File
@@ -2,10 +2,7 @@
name: critique
description: Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback.
user-invocable: true
args:
- name: area
description: The feature or area to critique (optional)
required: false
argument-hint: "[area (feature, page, component...)]"
---
## MANDATORY PREPARATION
+1 -4
View File
@@ -2,10 +2,7 @@
name: delight
description: Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful.
user-invocable: true
args:
- name: target
description: The feature or area to add delight to (optional)
required: false
argument-hint: "[target]"
---
Identify opportunities to add moments of joy, personality, and unexpected polish that transform functional interfaces into delightful experiences.
+1 -4
View File
@@ -2,10 +2,7 @@
name: distill
description: Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean.
user-invocable: true
args:
- name: target
description: The feature or component to distill (optional)
required: false
argument-hint: "[target]"
---
Remove unnecessary complexity from designs, revealing the essential elements and creating clarity through ruthless simplification.
+1 -4
View File
@@ -2,10 +2,7 @@
name: extract
description: Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library.
user-invocable: true
args:
- name: target
description: The feature, component, or area to extract from (optional)
required: false
argument-hint: "[target]"
---
Identify reusable patterns, components, and design tokens, then extract and consolidate them into the design system for systematic reuse.
+1 -4
View File
@@ -2,10 +2,7 @@
name: harden
description: Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready.
user-invocable: true
args:
- name: target
description: The feature or area to harden (optional)
required: false
argument-hint: "[target]"
---
Strengthen interfaces against edge cases, errors, internationalization issues, and real-world usage scenarios that break idealized designs.
+1 -4
View File
@@ -2,10 +2,7 @@
name: normalize
description: Normalize design to match your design system and ensure consistency
user-invocable: true
args:
- name: feature
description: The page, route, or feature to normalize (optional)
required: false
argument-hint: "[feature (page, route, component...)]"
---
Analyze and redesign the feature to perfectly match our design system standards, aesthetics, and established patterns.
+1 -4
View File
@@ -2,10 +2,7 @@
name: onboard
description: Design or improve onboarding flows, empty states, and first-time user experiences. Helps users get started successfully and understand value quickly.
user-invocable: true
args:
- name: target
description: The feature or area needing onboarding (optional)
required: false
argument-hint: "[target]"
---
## MANDATORY PREPARATION
+1 -4
View File
@@ -2,10 +2,7 @@
name: optimize
description: Improve interface performance across loading speed, rendering, animations, images, and bundle size. Makes experiences faster and smoother.
user-invocable: true
args:
- name: target
description: The feature or area to optimize (optional)
required: false
argument-hint: "[target]"
---
Identify and fix performance issues to create faster, smoother user experiences.
+1 -4
View File
@@ -2,10 +2,7 @@
name: overdrive
description: Push interfaces past conventional limits with technically ambitious implementations. Whether that's a shader, a 60fps virtual table, spring physics on a dialog, or scroll-driven reveals — make users ask "how did they do that?"
user-invocable: true
args:
- name: target
description: The feature or area to push into overdrive (optional)
required: false
argument-hint: "[target]"
---
Start your response with:
+1 -4
View File
@@ -2,10 +2,7 @@
name: polish
description: Final quality pass before shipping. Fixes alignment, spacing, consistency, and detail issues that separate good from great.
user-invocable: true
args:
- name: target
description: The feature or area to polish (optional)
required: false
argument-hint: "[target]"
---
## MANDATORY PREPARATION
+1 -4
View File
@@ -2,10 +2,7 @@
name: quieter
description: Tone down overly bold or visually aggressive designs. Reduces intensity while maintaining design quality and impact.
user-invocable: true
args:
- name: target
description: The feature or component to make quieter (optional)
required: false
argument-hint: "[target]"
---
Reduce visual intensity in designs that are too bold, aggressive, or overstimulating, creating a more refined and approachable aesthetic without losing effectiveness.
+1 -4
View File
@@ -2,10 +2,7 @@
name: typeset
description: Improve typography by fixing font choices, hierarchy, sizing, weight consistency, and readability. Makes text feel intentional and polished.
user-invocable: true
args:
- name: target
description: The feature or component to improve typography for (optional)
required: false
argument-hint: "[target]"
---
Assess and improve typography that feels generic, inconsistent, or poorly structured — turning default-looking text into intentional, well-crafted type.