Compiling Taste: Inside pbakaus/impeccable
How a collection of Markdown files forces AI coding agents to abandon generic templates and engineer mathematically precise interfaces.
Every LLM learned from the same generic templates. Without guidance, you get the same predictable mistakes: Inter font, purple gradients, cards nested in cards, gray text on colored backgrounds.
- Impeccable is not a component library, but a 'vocabulary layer' of pure Markdown that injects high-end design constraints into the context window of AI agents.
- It replaces subjective stylistic suggestions with objective mathematical rules, mandating OKLCH color spaces, fluid typography via clamp(), and precise cubic-bezier motion curves.
- The framework shifts the developer's role from writing CSS boilerplate to curating the rules of the system through 20 specialized slash commands.
The Gravity of the Median
AI coding agents have largely solved the blank page problem. The challenge now is what fills it. Because Large Language Models are trained on the entirety of the internet, their output naturally gravitates toward the median. The result is a proliferation of functional but visually exhausted interfaces: Inter font, generic cards nested within cards, and the ubiquitous purple gradient.
The problem isn't that AI cannot write code; the problem is that AI has terrible taste. It builds what it has seen most often, not what is best. Impeccable, an open-source framework by Paul Bakaus, exists to break this gravitational pull. It does this not by providing a traditional CSS component library, but by explicitly blacklisting the lazy defaults.
Prompting as a Standard Library
Impeccable is architected as a meta-framework. It distributes its logic across hidden dot-directories (.claude/, .cursor/) tailored to specific AI IDEs. At its core is a Context Gathering Protocol. Before the AI writes a single line of code, this protocol forces the agent to read strict DO/DON'T guidelines.
This approach treats prompt engineering like a version-controlled standard library. By explicitly forbidding the AI from inferring context from existing boilerplate, Impeccable acts as a contextual brain transplant, forcing the model to engineer interfaces like a senior design technologist.
Mathematical Aesthetics
The most fascinating aspect of Impeccable is how it translates the subjective concept of 'good design' into objective math. The reference documentation doesn't just offer visual tips; it enforces strict CSS logic.
For color, it mandates OKLCH to ensure perceptual uniformity, treating color as a mathematical function of lightness and brand hue rather than arbitrary hex codes. For typography, it requires fluid scaling using specific clamp() offsets. For motion, it replaces generic ease-in-out strings with precise cubic-bezier curves, governed by what it calls the '100/300/500 Rule'.
| Feature | Default AI Model | Impeccable-Steered AI |
|---|---|---|
| Color | Hex/RGB palettes | OKLCH with constrained chroma |
| Typography | Static pixels & Inter/Roboto | Fluid clamp() & deliberate blacklists |
| Motion | Generic ease-in-out strings | Specific cubic-bezier curves (100/300/500 Rule) |
| Layout | Nested absolute positioning | CSS Anchor Positioning & Container Queries |
The Terminal Art Director
The developer experience revolves around 20 user-invocable slash commands, such as /audit, /polish, and /bolder. These commands are mapped to specific sub-skills within the framework.
By typing /audit, the developer triggers a comprehensive review of the current component against Impeccable's mathematical constraints. The AI is transformed from a passive code generator into an active art director, allowing the human to iterate on design choices without ever leaving the CLI.
Impeccable is the first tool that directly attacks this problem – a structured design language that plugs into your AI agent and rewires how it thinks about visual design.
As AI increasingly handles the boilerplate of writing code, tools like Impeccable highlight the new high-value skill: curating the rules of the system. It is the compiler for taste.