Introducing a new way to review your PRs.

Read the announcement

pbakaus / impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

View on GitHub

32 documents · Updated Nov 20, 2026

overview

Knowledge Base updated: 2026-11-19

Impeccable knowledge base

Impeccable is a design-quality toolkit spanning a browser extension, an installed AI-agent skill and plugin, JavaScript build tooling, and a Rust native runtime. It detects UI issues, captures browser evidence, guides design workflows, and connects agent clients to local project operations.

The browser extension owns inspected-page integration, popup and DevTools surfaces, account state, and guided Walks. The plugin and skill provide agent-facing commands, hooks, references, and provider integrations. The Rust workspace provides CLI dispatch plus context, account, capture, composition, and MCP-oriented services.

Critical persisted state includes project design-context and critique artifacts, account/session and entitlement data, component-review plans and evidence, extension storage, and generated build or package outputs.

flowchart TD
  User[Designer or coding agent] --> Skill[Plugin and installed skill]
  User --> Extension[Browser extension]
  Skill --> CLI[Rust CLI]
  Extension --> Pages[Inspected web pages]
  Extension --> Walks[Account and guided Walks]
  CLI --> Detector[UI quality detector]
  CLI --> Context[Design context runtime]
  CLI --> Account[Account and Pro services]
  CLI --> Capture[Native capture and component review]
  CLI --> MCP[Agent protocol services]
  Detector --> Browser[Browser analysis runtime]
  Context --> Artifacts[Context and critique artifacts]
  Capture --> Review[Review plans and visual evidence]
  MCP --> Clients[External coding-agent clients]
  Build[Build, test, and release tooling] --> Extension
  Build --> Skill
  Build --> CLI
flowchart LR
  Target[Target project] --> Select[Select target and detect framework]
  Select --> Inject[Inject browser workflow]
  Inject --> Generate[Generate changes]
  Generate --> Poll[Poll and validate]
  Poll --> Decide{Accept?}
  Decide -->|Yes| Complete[Complete session]
  Decide -->|No| Discard[Discard or recover]

Glossary

  • Walks — extension-guided inspection sessions that instrument a page, request consent, and hand findings to an agent workflow.
  • Design context — persisted design-direction artifacts such as concepts, palettes, composition data, surface briefs, and pinned decisions.
  • Critique artifact — stored feedback and associated staleness signals used by subsequent design workflows.
  • Component review plan — persisted mapping and lifecycle state for component-fidelity capture and comparison work.
  • Taste/world workflow — native workflow that establishes reusable design direction and service-backed guidance.

Codebase-wide invariants

Routing table