mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-16 16:16:32 +03:00
Paul BakausandClaude Opus 4.5
0b9c1846a6
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>
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
---
|
|
name: teach-impeccable
|
|
description: One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines.
|
|
---
|
|
|
|
Gather design context for this project, then persist it for all future sessions.
|
|
|
|
## Step 1: Explore the Codebase
|
|
|
|
Before asking questions, thoroughly scan the project to discover what you can:
|
|
|
|
- **README and docs**: Project purpose, target audience, any stated goals
|
|
- **Package.json / config files**: Tech stack, dependencies, existing design libraries
|
|
- **Existing components**: Current design patterns, spacing, typography in use
|
|
- **Brand assets**: Logos, favicons, color values already defined
|
|
- **Design tokens / CSS variables**: Existing color palettes, font stacks, spacing scales
|
|
- **Any style guides or brand documentation**
|
|
|
|
Note what you've learned and what remains unclear.
|
|
|
|
## Step 2: Ask UX-Focused Questions
|
|
|
|
{{ask_instruction}} Focus only on what you couldn't infer from the codebase:
|
|
|
|
### Users & Purpose
|
|
- Who uses this? What's their context when using it?
|
|
- What job are they trying to get done?
|
|
- What emotions should the interface evoke? (confidence, delight, calm, urgency, etc.)
|
|
|
|
### Brand & Personality
|
|
- How would you describe the brand personality in 3 words?
|
|
- Any reference sites or apps that capture the right feel? What specifically about them?
|
|
- What should this explicitly NOT look like? Any anti-references?
|
|
|
|
### Aesthetic Preferences
|
|
- Any strong preferences for visual direction? (minimal, bold, elegant, playful, technical, organic, etc.)
|
|
- Light mode, dark mode, or both?
|
|
- Any colors that must be used or avoided?
|
|
|
|
### Accessibility & Inclusion
|
|
- Specific accessibility requirements? (WCAG level, known user needs)
|
|
- Considerations for reduced motion, color blindness, or other accommodations?
|
|
|
|
Skip questions where the answer is already clear from the codebase exploration.
|
|
|
|
## Step 3: Write Design Context
|
|
|
|
Synthesize your findings and the user's answers into a `## Design Context` section:
|
|
|
|
```markdown
|
|
## Design Context
|
|
|
|
### Users
|
|
[Who they are, their context, the job to be done]
|
|
|
|
### Brand Personality
|
|
[Voice, tone, 3-word personality, emotional goals]
|
|
|
|
### Aesthetic Direction
|
|
[Visual tone, references, anti-references, theme]
|
|
|
|
### Design Principles
|
|
[3-5 principles derived from the conversation that should guide all design decisions]
|
|
```
|
|
|
|
Write this section to {{config_file}} in the project root. If the file exists, append or update the Design Context section.
|
|
|
|
Confirm completion and summarize the key design principles that will now guide all future work.
|