Commit Graph
80 Commits
Author SHA1 Message Date
Paul BakausandClaude Opus 4.5 020ac82748 Add mandatory preparation to design-transformative commands
Commands now require context gathering before proceeding:
- bolder: target audience, use-cases, brand personality
- quieter: purpose, audience, what's working
- colorize: brand colors, audience, domain appropriateness
- animate: personality, performance budget, audience
- delight: brand personality, emotional context, appropriateness
- simplify: what's essential vs nice-to-have

Each command now:
1. Gathers context from thread/codebase first
2. MUST ask user if inference confidence is medium or lower
3. MUST use frontend-design skill before proceeding
4. Has visual separator (---) as hard gate before design work

This prevents AI slop by ensuring commands have proper context
before making design decisions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 15:11:05 -08:00
Paul BakausandClaude Opus 4.5 825d936f20 Add mandatory context gathering to frontend-design skill
- Add "MANDATORY: Context Gathering (Do This First)" section with 3 procedural steps
- Require scanning codebase for README, brand guidelines, design tokens before design
- Must answer: target audience, brand personality, existing tokens/colors/fonts
- Hard gate: STOP and ask user if ANY question is unclear
- Visual separator (---) prevents proceeding without completing steps
- Preserves full Tone options and Design Direction content

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 14:48:40 -08:00
Paul BakausandClaude Opus 4.5 41a557a675 Remove context: fork from commands (blocks AskUserQuestionTool)
Removed from: critique, audit, extract

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 14:22:15 -08:00
Paul BakausandClaude Opus 4.5 7d43765600 Allow monospace as intentional accent in bolder command
Monospace is fine when used intentionally - the issue is lazy "dev tool"
defaults, not the typeface itself.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 14:11:49 -08:00
Paul BakausandClaude Opus 4.5 c4c5661392 Harden bolder command against AI slop
- Added explicit AI SLOP TRAP warning before planning
- Removed "monospace as accent" suggestion (contradicts skill)
- Replaced glassmorphism with grain, halftone, duotone alternatives
- Added anti-slop caveats to shadows and borders suggestions
- Added "NOT AI slop" as first verification check
- Added "the test" to verify section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 14:11:05 -08:00
Paul BakausandClaude Opus 4.5 e4f2ef361e Fix pattern parsing: restore DO/DON'T format, add Visual Details section
- Restored DO/DON'T format in individual sections (required for website)
- Added new "Visual Details" section for glassmorphism, sparklines, etc.
- Added new AI slop patterns: gradient text, dark mode with glowing accents,
  hero metric layout, identical card grids, thick colored border on one side
- Added "The AI Slop Test" section for commands to reference
- Commands now reference "DON'T guidelines" (one source of truth)
- Build now shows 16 pattern categories (was 0)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 14:04:19 -08:00
Paul BakausandClaude Opus 4.5 46fa43ced6 Consolidate all anti-patterns into single skill section
- Removed scattered DON'Ts from individual Frontend Aesthetics sections
- Created ONE "Anti-Patterns (CRITICAL)" section with two sub-sections:
  - AI Slop Tells: cyan-on-dark, gradient text, glassmorphism, hero metrics, etc.
  - Design Anti-Patterns: gray on color, nested cards, bounce easing, etc.
- Added new pattern: "Rounded element with thick colored border on one side"
- Commands now reference the skill's Anti-Patterns section instead of duplicating
- Easier to maintain: one place to update

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:59:13 -08:00
Paul BakausandClaude Opus 4.5 6bad6f1555 Add AI Slop Detection to critique and audit commands
Critical addition: Both commands now check for AI-generated aesthetic tells:
- Cyan-on-dark, purple-to-blue gradients, neon accents
- Gradient text, glassmorphism, hero metric layouts
- Monospace typography, sparklines as decoration
- Identical card grids, generic fonts, rounded rectangles

Reports now start with "AI Slop Verdict" - pass/fail on distinctiveness.
This is the most important quality signal for shipping work that doesn't
look like every other AI-generated interface.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:50:22 -08:00
Paul BakausandClaude Opus 4.5 ee4d2e1098 Fix skill invocation and make ask instruction more prominent
- Commands now say "Use the frontend-design skill" instead of passive note
- Skill's Design Thinking section now has explicit MUST-know checklist
- Added ask instruction to bolder command for context gathering
- AskUserQuestionTool instruction is now more prominent and imperative

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:38:00 -08:00
Paul BakausandClaude Opus 4.5 f6cba74a3c Update dashboard after image
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:13:12 -08:00
Paul BakausandClaude Opus 4.5 df02f9c158 Reorder case study tabs: Landing Page, Form UX, Dashboard
Put stronger examples first.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:12:12 -08:00
Paul BakausandClaude Opus 4.5 c981e1b9ea Add case study images for dashboard, landing, and form
Replaced placeholder divs with actual before/after webp images
for all three transformation examples.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:07:46 -08:00
Paul BakausandClaude Opus 4.5 bf5b95319b Fix tool name: AskUserQuestionTool (not AskUserQuestion)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:05:05 -08:00
Paul BakausandClaude Opus 4.5 e929914841 Make AskUserQuestion instruction more imperative for Claude Code
Changed from passive "use the AskUserQuestion tool" to imperative
"STOP and call the AskUserQuestion tool" to ensure Claude actually
asks clarifying questions when context is missing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:01:58 -08:00
Paul BakausandClaude Opus 4.5 bd76b63b8e Add FAQ section with accordion-style questions
Covers:
- Where to put downloaded files (project vs global)
- Troubleshooting missing commands/skills
- Getting started resources for beginners

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 09:08:40 -08:00
Paul BakausandClaude Opus 4.5 71d34aa31e Fix download card button alignment
Remove margin-top: auto which caused whitespace on cards without
setup instructions. Buttons now flow naturally with consistent spacing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 08:54:24 -08:00
Paul BakausandClaude Opus 4.5 4b875f4998 Add Cursor skills setup instructions
Cursor Agent Skills also require setup:
1. Switch to Nightly channel
2. Enable Agent Skills in Settings → Rules

Added collapsible instructions to Cursor download card and README.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 08:52:42 -08:00
Paul BakausandClaude Opus 4.5 d5c2f595f1 Add Gemini CLI native skills support
Gemini CLI now supports Agent Skills (experimental), so we can use the
standard .gemini/skills/ directory format instead of context file workarounds.

Changes:
- Update Gemini transformer to output proper skills directory structure
- Add collapsible setup instructions to Gemini download card
- Update README with Gemini CLI skills setup instructions
- Fix /review -> /critique in README command table
- Remove old GEMINI.md context file workaround

Setup requires:
1. npm i -g @google/gemini-cli@preview
2. /settings -> enable Skills
3. /skills list to verify

Docs: https://geminicli.com/docs/cli/skills/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 08:46:17 -08:00
Paul BakausandClaude Opus 4.5 9d2d31b108 Add missing /api/command-source Vercel endpoint
This endpoint was in the local server but missing from Vercel serverless
functions, causing "Source not available" on the deployed site.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 20:20:13 -08:00
Paul BakausandClaude Opus 4.5 bf9ab968bc Fix Gemini download note - skills are bundled as context files
Gemini does get skill content via GEMINI.frontend-design.md imports,
just not through a native skill system. Updated note to reflect this.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 20:13:51 -08:00
Paul BakausandClaude Opus 4.5 123f4eb520 Simplify download cards to essentials only
- Remove redundant "Full Featured" badges (all are full featured)
- Remove paragraph descriptions (didn't add value)
- Center-align cards for cleaner visual
- Add "Commands only (no skills yet)" note for Gemini
- Slightly larger icons, tighter spacing

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 20:11:33 -08:00
Paul BakausandClaude Opus 4.5 3083f8addc Add prefixed command option to avoid conflicts
Users can now toggle "Prefix commands with /i-" in the download section
to get bundles with all commands prefixed (e.g., /i-audit instead of /audit).
This helps avoid conflicts with existing custom commands.

Build system changes:
- Transformers now accept optional prefix/outputSuffix parameters
- Build generates both unprefixed and i-prefixed variants
- ZIP bundles created for both variants

UI changes:
- Add toggle switch to download section
- Toggle controls which bundle variant gets downloaded
- Styled to match existing design language

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 20:06:36 -08:00
Paul BakausandClaude Opus 4.5 8a4e4bd380 Fix periodic table to use critique instead of review
Update commandSymbols and commandNumbers mappings.
Symbol: Cr (for Critique)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 18:59:44 -08:00
Paul BakausandClaude Opus 4.5 d7937b1844 Rename /review command to /critique to avoid Claude conflict
The /review command conflicts with a built-in Claude Code command.
Renamed to /critique which better reflects design terminology.

- Rename source/commands/review.md → critique.md
- Update command content and descriptions
- Rename demo file and update references
- Update data.js command mappings
- Update case study example in index.html
- Rebuild dist files for all providers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 18:57:55 -08:00
Paul BakausandClaude Opus 4.5 023005bea3 Link author name to X profile
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 18:54:38 -08:00
Paul BakausandClaude Opus 4.5 dade431495 Add enhanced footer with social links and newsletter CTA
- Add X/Twitter and LinkedIn social icons to footer
- Add "Renaissance Geek" newsletter button with arrow animation
- Create dedicated author section with subtle divider styling
- Responsive layout that stacks on mobile

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 18:54:01 -08:00
Paul BakausandClaude Opus 4.5 af21bf2d34 Add tabbed case studies, CLAUDE.md, and various improvements
- Convert "See It In Action" section to tabbed interface for space efficiency
- Add CLAUDE.md with project instructions for CSS build process
- Update README with additional documentation
- Enhance glass terminal component
- Add new API handlers and server routes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 18:08:04 -08:00
Paul BakausandClaude Opus 4.5 0b9c1846a6 Add teach-impeccable and review commands, dynamic placeholders
New commands:
- /teach-impeccable: One-time setup that gathers UX-focused design
  context (explores codebase first, then asks targeted questions)
- /review: UX design review evaluating hierarchy, clarity, emotional
  resonance (complements technical /audit)

Build system improvements:
- Dynamic {{model}}, {{ask_instruction}}, {{config_file}} placeholders
  per provider (Claude/Gemini/GPT/the model)
- context: fork support for Claude Code sub-agents (audit, extract)
- Skill reference auto-added to design commands

Skill refinements:
- Merged Design Thinking and Context Awareness sections
- Removed redundant patterns and technical questions
- More direct feedback guidance (radical candor)

Website updates:
- 17 commands (was 16)
- Review demo showing UX issues (HIERARCHY, NO PRIMARY, DEAD END)
- teach-impeccable in System group of periodic table

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 16:56:08 -08:00
Paul BakausandClaude Opus 4.5 8186f2a226 Update README and license to Apache 2.0
- Rewrite README to be user-focused (move dev info to DEVELOP.md)
- Credit Anthropic's original frontend-design skill
- Change license from MIT to Apache 2.0 for consistency
- Add NOTICE.md with proper attribution

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:50:53 -08:00
Paul BakausandClaude Opus 4.5 b264065cc4 Prepare for launch
- Add meta description and OpenGraph tags for social sharing
- Create OG image (SVG)
- Fix README: "Design Language" → "Impeccable"
- Fix DEVELOP.md: update build script line count

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 18:49:30 -08:00
Paul BakausandClaude Opus 4.5 7c33c90f82 Add favicon with slash symbol
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 18:44:48 -08:00
Paul BakausandClaude Opus 4.5 8ef37b011c Add mobile layout for commands section
- New carousel + demo + info layout for commands on mobile (<900px)
- Add touch support to framework viz (tap instead of hover)
- Fix split-content width for demo comparisons

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 18:41:34 -08:00
Paul BakausandClaude Opus 4.5 61d26a7370 Update hero content and add pattern contribution CTA
- Simplify hero overlay (remove badge, update tagline)
- Add "What's Included" header to equation section
- Add contribution CTA to Antidote section with GitHub link

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 18:04:18 -08:00
Paul BakausandClaude Opus 4.5 bf247c5e14 Rename repository from vibe-design-plugins to impeccable
Update all references in docs, package.json, and website links.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 17:47:59 -08:00
Paul BakausandClaude Opus 4.5 97c83fc51a Add animated mesh gradient hero with overlay content
- Add @paper-design/shaders for WebGL mesh gradient effect
- Create hero-shader.js with liquid ink gradient (grayscale palette)
- Add overlay content: title, tagline, and CTA on shader
- Update hero section structure and styling
- Fix accessibility: gallery dot buttons, toggle ARIA attributes
- Fix undefined --color-terracotta CSS variable
- Update distribution structure for Codex/Cursor skills

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 17:46:49 -08:00
Paul BakausandClaude Opus 4.5 f75321b2c1 Increase impeccable-card height for bottom breathing room
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:24:20 -08:00
Paul BakausandClaude Opus 4.5 4b2a967713 Reduce impeccable-button margin (24px -> 16px)
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:22:45 -08:00
Paul BakausandClaude Opus 4.5 649d544484 Fix impeccable-button spacing (remove duplicate margin-top)
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:22:18 -08:00
Paul BakausandClaude Opus 4.5 3e7e5b30ff Fix hero button hover state (add span wrapper)
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:21:07 -08:00
Paul BakausandClaude Opus 4.5 a0b7e9918a Fix button spacing in split-screen demo
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:20:30 -08:00
Paul BakausandClaude Opus 4.5 0cb3da1616 Improve website copy: less salesy, credit Anthropic
- Hero: simpler, factual description
- Problem section: remove em dash, less dramatic
- Antidote: properly credit Anthropic's original skill

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 18:02:58 -08:00
Paul Bakaus 8d5260a26d new patterns 2025-12-16 18:00:03 -08:00
Paul BakausandClaude Opus 4.5 de0bebbcec Update README to reflect current architecture
- Clarify: 1 skill with 7 reference files (not 8 separate skills)
- Add "The Problem" section about AI design bias
- Simplify installation and usage sections
- Add patterns/anti-patterns summary
- Add author credit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 17:48:10 -08:00
Paul BakausandClaude Opus 4.5 e99828bfdf Add author credit to footer
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 17:43:08 -08:00
Paul BakausandClaude Opus 4.5 2356ae7f2f Add perceived performance section to motion-design reference
- 80ms threshold for "instant" perception
- Active vs passive time (preemptive start, early completion)
- Optimistic UI patterns with appropriate use cases
- Easing affects perceived duration (peak-end effect)
- Caution: too-fast can decrease perceived value

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 17:39:44 -08:00
Paul BakausandClaude Opus 4.5 fccfde2a0b Trim skill and reference files for conciseness (~56% reduction)
- Remove redundant intro scaffolding from all reference files
- Cut basic code examples LLMs already know (CSS vars, simple patterns)
- Keep non-obvious techniques (OKLCH, fallback fonts, container queries, etc.)
- Simplify SKILL.md reference section to single-line links
- Total: 1,908 → 838 lines across skill + 7 reference files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 17:34:03 -08:00
Paul BakausandClaude Opus 4.5 fe5741d01b Further trim patterns to essential AI-bias-fighting guidance
Reduced to most impactful items only:
- Typography: modular scale, distinctive fonts, avoid overused fonts
- Color: off-whites/near-blacks, modern CSS, no gray on color, always tint
- Layout: visual rhythm, asymmetry, grid-breaking, no card obsession, modals are lazy
- Motion: no layout animation, no bounce/elastic
- Interaction: no redundant copy
- Responsive: don't hide mobile functionality

9 categories, ~15 items total - lean and focused.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 16:46:40 -08:00
Paul BakausandClaude Opus 4.5 8e4f48566f Trim patterns to non-obvious, AI-bias-fighting guidance only
Removed items that are:
- Accessibility 101 (WCAG, color blindness, reduced motion, focus indicators)
- Basic design principles (hierarchy, readability, semantic tokens)
- Well-known rules (2-3 fonts max, mobile-first, decorative body fonts)

Kept items that fight specific AI biases:
- Off-whites/near-blacks, dominant color with accents
- Spacing scales, asymmetry, staggered reveals
- Bounce/elastic easing ban, cards-on-cards
- Gray text on color, placeholder-as-labels, generic errors

Reduced from 60 items to 34 - more focused and actionable.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 15:42:28 -08:00
Paul BakausandClaude Opus 4.5 df981860c2 Generate patterns section from YAML data (single source of truth)
- Updated claude-code transformer to generate markdown from YAML patterns/antipatterns
- Removed redundant prose body from patterns.md
- SKILL.md now contains detailed lists (5 items per category) instead of condensed prose
- patterns.md YAML frontmatter is now the single source of truth for both:
  - Website API (/api/patterns)
  - Generated skill files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 15:35:38 -08:00
Paul BakausandClaude Opus 4.5 7bc51c2b3d Redesign: Move before/after demo to hero position in problem section
- Before/after split comparison now appears immediately after the lead text
- Replaced verbose 6-card bias grid with compact horizontal tag row
- Demo is now the hero moment, biases are supporting context
- Better visual hierarchy and flow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 15:14:34 -08:00