Getting started

Go from installation to a first polish pass in about ten minutes.

Prerequisites

• A supported AI coding harness such as Codex, Claude Code, Cursor, GitHub Copilot, or Gemini CLI.
• A project with an existing page or component to improve.

1. Install

From the project root:

npx impeccable install

Reload the harness after installation. Use npx impeccable check to see whether the installed copy is behind, and npx impeccable update to update it.

2. Capture project context

/impeccable init

init scans the project, confirms anything it cannot safely infer, and writes PRODUCT.md. It may offer /impeccable document to capture an existing visual system in DESIGN.md.

3. Improve a real page

/impeccable polish the pricing page

Review the resulting diff. A polish pass should preserve the page's identity and behavior while improving alignment, spacing, typography, states, motion, and copy.

Next steps

• Use live for focused browser iteration.
• Use critique for design judgment and prioritization.
• Use audit for accessibility, performance, responsive, and implementation checks.
• Run npx impeccable detect src/ for deterministic anti-pattern detection.