How pbakaus/impeccable works
Impeccable equips coding agents to steer and review interface design, while also providing deterministic design detection and browser-based iteration. The main workflow is an agent command applied to a target, informed by project context; separate workflows scan source or rendered pages and let users review or accept live variants. The README documents these product capabilities; sampled-source relationships are cited where visible, and unsampled subsystems are represented only at paths supported by the tree.
Main entry points: context_cli.rs Agent commands · engines.rs Engine seams · static_engine.rs Static HTML scan · snapshot_engine.rs Browser URL scan
Components 23
Agent guidance
- Agent commands
crates/context/src/context_cli.rs - Project context
crates/context/src/context.rs - Command playbooks
skill - Critique storage
crates/context/src/critique_storage.rs
Design detection
- Detect CLI
crates/detect/src/cli.rs - Engine seams
crates/detect/src/engines.rs - Static HTML scan
crates/html/src/static_engine.rs - HTML rule engine
crates/html/src/engine.rs - Static DOM and cascade
crates/html/src/dom.rs - Browser URL scan
crates/browser/src/snapshot_engine.rs - Chrome DevTools
crates/browser/src/cdp.rs - Design rules
crates/core/src/checks/text_context.rs
Live iteration
- Live session server
crates/live/src/server.rs - Live edit workflow
crates/live/src/live_generate.rs - Accept variants
crates/live/src/live_accept.rs
Component review
- Review server
crates/context/src/component_review/server.rs - Component review UI
ui/component-review/review.ts - Plan and asset review
ui/component-review/plan-review.ts
Tool integrations
- Browser extension
extension/background/service-worker.js - Design hook sessions
crates/hook/src/hook_sessions.rs
Other components
- Designer or developer
- Running browser page
- Coding agent
Connections 23
- Designer or developer → Agent commands: runs command
README.md - Agent commands → Project context: reads and writes
README.md - Agent commands → Command playbooks: loads playbook
README.md - Agent commands → Critique storage: stores reviews
- Designer or developer → Detect CLI: starts scan
README.md - Detect CLI → Engine seams: selects engine
crates/detect/src/engines.rs - Engine seams → Static HTML scan: uses HTML engine
crates/html/src/static_engine.rs - Static HTML scan → HTML rule engine: adapts scan
crates/html/src/static_engine.rs - HTML rule engine → Static DOM and cascade: queries document
crates/html/src/engine.rs - Engine seams → Browser URL scan: uses URL engine
crates/detect/src/engines.rs - Browser URL scan → Chrome DevTools: drives browser
crates/browser/src/snapshot_engine.rs - Static HTML scan → Design rules: runs analyzers
- Browser URL scan → Design rules: applies rules
- Designer or developer → Live session server: starts live mode
README.md - Live session server → Running browser page: opens overlay
README.md - Running browser page → Live edit workflow: selects element
README.md - Live edit workflow → Accept variants: submits variant
README.md - Accept variants → Running browser page: writes source
README.md - Designer or developer → Review server: opens review
- Review server → Component review UI: serves review
- Component review UI → Plan and asset review: mounts plan review
ui/component-review/review.ts - Designer or developer → Browser extension: opens overlay
README.md - Coding agent → Design hook sessions: checks edits
README.md