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
- Extension capabilities and page access must be declared consistently with the service-worker and content integration in extension/manifest.json and
extension/background/**. - Agent-facing workflows preserve durable design context rather than treating critique output as transient; evidence is represented by
crates/context/src/**storage and staleness modules. - Native command capabilities are reached through the Rust CLI dispatch boundary, centered on crates/…/lib.rs and crates/…/router.rs.
- Release deliverables are validated through repository scripts and CI rather than ad hoc packaging; see scripts/build.js, scripts/build-extension.js, and .github/…/ci.yml.
- Provider-specific plugin metadata remains part of the distributable integration surface in plugin/…/plugin.json and plugin/…/plugin.json.
Routing table
-
crates/detector/**,crates/core/src/checks/**-> UI quality detection system -
crates/…/detect*.rs, crates/…/*config*.rs -> Detector commands and configuration
-
crates/detector/src/**,crates/core/src/**/filesystem/**-> Detector analysis pipeline -
crates/core/src/checks/**,crates/detector/src/**/rule*-> Detection engines and antipattern rules -
crates/browser/**,crates/**/src/**/wasm/**-> Browser analysis runtime -
crates/**/src/**/{color,font,page,cascade}*-> Design system profiling -
crates/**/src/**/motion*,tests/**/*motion*-> Motion capture analysis -
plugin/…/SKILL.md,
plugin/agents/**-> Agent-assisted design workflows -
crates/…/loop_*.rs, plugin/…/live.md -> Live editing sessions
-
crates/…/hook_*.rs,
plugin/**/hook*-> Agent hooks and edit interception -
crates/context/src/**,crates/account/src/{design,critiques,world}.rs-> Design context and critique artifacts -
plugin/skills/impeccable/reference/**,plugin/skills/impeccable/commands/**-> Skill commands and reference guidance -
plugin/.claude-plugin/**,plugin/.grok-plugin/**,plugin/**/provider*-> AI provider integration -
crates/capture/**,crates/**/src/**/*review*-> Native capture and component review -
crates/**/src/**/*fidelity*,crates/**/src/**/*compare*,crates/**/src/**/*diff*-> Component fidelity review workflow -
crates/**/src/**/*plan*,crates/**/src/**/*plate*-> Component review planning -
extension/**-> Browser extension product -
extension/manifest.json,
extension/background/**,extension/content/**-> Extension page integration -
extension/devtools/**,extension/popup/**-> Extension DevTools and popup interfaces -
extension/account/**,extension/walks/**, extension/…/build.js -> Extension account and guided walks -
package.json,
scripts/**,.github/workflows/**-> Distribution and engineering tooling -
plugin/.claude-plugin/**,plugin/.grok-plugin/**,plugin/agents/**-> Plugin packaging and installation -
scripts/{build.js,build-extension.js,release.mjs,launch-smoke.sh,staging-cli-e2e.sh}, .github/…/ci.yml -> Build, release, and validation automation -
tests/**,fixtures/**-> Automated test harness -
Cargo.toml, Cargo.lock, crates/…/Cargo.toml -> Native runtime and CLI
-
crates/cli/**, crates/…/rules.rs -> Rust CLI runtime -
crates/mcp/**-> Agent protocol services -
crates/account/**-> Account and Pro access services -
crates/**/src/**/*seed*,crates/**/src/**/*direction*-> Design seed generation -
crates/**/src/**/*composition*,crates/**/src/**/*component*-> Component composition operations -
crates/cli/src/foundations/**, crates/…/world.rs -> Design foundations and taste workflows