# Impeccable Documentation

> Technical reference for Impeccable: the `/impeccable` design skill (23 commands), multi-harness installer, deterministic anti-pattern detector CLI and browser extension, live browser iteration, project artifacts, and contributor build/test surfaces.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4)
- [GitHub repository](https://github.com/pbakaus/impeccable)

## Repository

- Repository: pbakaus/impeccable

- Generated: 2026-08-05T07:51:10.999Z
- Updated: 2026-08-05T07:51:21.022Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 24

## Pages

- [Overview](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/01-overview.md): What Impeccable exposes (skill, CLI detector, extension, live mode), runtime assumptions, and the shortest path from install to first successful command.
- [Installation](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/02-installation.md): Install paths for npx install/link/update, plugin install, submodule link, provider selection, scope (project vs global), and hook consent constraints.
- [Quickstart](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/03-quickstart.md): First successful session: install skills, run `/impeccable init`, load context via context.mjs, run a scoped design command, and optionally scan with detect.
- [Modes and platform](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/04-modes-and-platform.md): Visitor modes (Persuade, Operate, Read, Experience) and orthogonal platform values (web, ios, android, adaptive), including defaults, native reference loading, and web-only live/detect boundaries.
- [Project artifacts](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/05-project-artifacts.md): PRODUCT.md, DESIGN.md, design.json sidecar, surface briefs, `.impeccable/` layout, schema stamps, deprecated sections, and context resolution order.
- [Commands and routing](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/06-commands-and-routing.md): Single `/impeccable` skill, 23 sub-commands, Setup load order, no-argument routing, craft-floor gate, and when native command variants replace web references.
- [Provider harnesses](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/07-provider-harnesses.md): Supported AI harness directories, install aliases, frontmatter and hook capability matrix, and provider-specific trust or skills-enable steps.
- [Initialize product context](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/08-initialize-product-context.md): Run init to interview and write PRODUCT.md (including Platform), optionally document DESIGN.md from code, configure live when useful, and verify completion gates.
- [Run design commands](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/09-run-design-commands.md): Invoke evaluate and refine commands (audit, critique, polish, harden, layout, typeset, and related) with targets, expected artifacts, and verification signals.
- [Live browser iteration](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/10-live-browser-iteration.md): Start live mode, poll contract, generate/accept/discard/steer/manual-edit events, carbonize cleanup, roots resolution, and web-only platform constraints.
- [Design hook](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/11-design-hook.md): Provider-native edit hooks that scan writes for detector findings, intentional-finding workflow, quiet/disabled controls, and native-platform skip behavior.
- [Pin shortcuts](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/12-pin-shortcuts.md): Create and remove standalone harness shortcuts (for example `/audit`) that redirect to `/impeccable <command>` across discovered skill directories.
- [Manage detector ignores](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/13-manage-detector-ignores.md): Add, list, and remove ignoreRules, ignoreFiles, and ignoreValues in shared or local config, including value scoping, reasons, and inline disable comments.
- [CLI reference](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/14-cli-reference.md): Commands for detect, ignores, install, link, update, check, and help: flags, defaults, exit codes, JSON output, URL scanning, and detect shorthand targets.
- [Skill commands reference](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/15-skill-commands-reference.md): Catalog of `/impeccable` sub-commands with argument hints, categories, reference files, and native variants for audit and adapt.
- [Detector rules](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/16-detector-rules.md): Deterministic rule registry: ids, slop vs quality categories, advisory rules, scopes, engines (jsdom, browser, regex), and finding shape for CLI and extension.
- [Configuration reference](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/17-configuration-reference.md): `.impeccable/config.json` and `config.local.json` keys for detector, hook, live, update, and staleness settings, plus live config.json fields and hard path excludes.
- [Environment variables](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/18-environment-variables.md): Documented IMPECCABLE_* and related env vars for context dir, update host/cache, live config, hook quiet/disable/depth/log, telemetry opt-out, and OpenCode config dirs.
- [Plugin agents](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/19-plugin-agents.md): Bundled finish-reviewer, documenter, asset-producer, and manual-edit-applier agents, plugin manifest contract, and hooks packaged for Claude Code and Grok plugin installs.
- [Live framework recipes](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/20-live-framework-recipes.md): Copy-paste live config shapes and adapter notes for Vite, Next.js, Nuxt, SvelteKit, TanStack, Astro, multipage, and CSP-aware fixtures under tests/framework-fixtures.
- [Detect in CI](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/21-detect-in-ci.md): Run impeccable detect non-interactively with --json/--quiet/--scope, interpret exit codes 0 and 2, apply project ignores, and wire optional Puppeteer URL scans.
- [Doctor](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/22-doctor.md): Run doctor for schema, config, and proxy truth-drift findings; apply auto fixes; route mention and route severities; opt out of boot staleness checks.
- [Build and test](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/23-build-and-test.md): Source-first vs release builds, browser and extension bundles, default and opt-in test suites (live-e2e, skill-behavior, plugin-e2e), and suite trigger mapping.
- [Contributing](https://grok-wiki.com/public/docs/pbakaus-impeccable-adadc04d8de4/pages/24-contributing.md): Source-of-truth layout under skill/, generated harness policy, issue-first PR rules, anti-pattern TDD order, and component release tags (skill-v, cli-v, ext-v).

## Source Files

- `.claude-plugin/plugin.json`
- `AGENTS.md`
- `cli/bin/cli.js`
- `cli/bin/commands/ignores.mjs`
- `cli/bin/commands/skills.mjs`
- `cli/engine/cli/main.mjs`
- `cli/engine/detect-antipatterns.mjs`
- `cli/engine/engines/regex/detect-text.mjs`
- `cli/engine/engines/static-html/detect-html.mjs`
- `cli/engine/findings.mjs`
- `cli/engine/registry/antipatterns.mjs`
- `cli/engine/rules/checks.mjs`
- `cli/engine/shared/inline-ignores.mjs`
- `cli/lib/impeccable-config.mjs`
- `docs/adr-live-variant-mode.md`
- `docs/DEVELOP.md`
- `docs/HARNESSES.md`
- `docs/STYLE.md`
- `package.json`
- `plugin/hooks/hooks.json`
- `PRODUCT.md`
- `README.md`
- `README.npm.md`
- `scripts/benchmark-detector.mjs`
- `scripts/build.js`
- `scripts/lib/skill-categories.js`
- `scripts/lib/transformers/providers.js`
- `scripts/lib/utils.js`
- `scripts/lib/validate-plugin-manifest.js`
- `scripts/release.mjs`
- `scripts/run-tests.mjs`
- `scripts/test-suites.mjs`
- `skill/agents/impeccable-asset-producer.md`
- `skill/agents/impeccable-documenter.md`
- `skill/agents/impeccable-finish-reviewer.md`
- `skill/agents/impeccable-manual-edit-applier.md`
- `skill/reference/adapt.native.md`
- `skill/reference/android.md`
- `skill/reference/audit.md`
- `skill/reference/audit.native.md`
- `skill/reference/craft-floor.md`
- `skill/reference/critique.md`
- `skill/reference/doctor.md`
- `skill/reference/document.md`
- `skill/reference/hooks.md`
- `skill/reference/init.md`
- `skill/reference/ios.md`
- `skill/reference/live-setup.md`
- `skill/reference/live.md`
- `skill/reference/new-work.md`
- `skill/reference/operate.md`
- `skill/reference/polish.md`
- `skill/reference/routing.md`
- `skill/scripts/command-metadata.json`
- `skill/scripts/concept-seed.mjs`
- `skill/scripts/context-signals.mjs`
- `skill/scripts/context.mjs`
- `skill/scripts/critique-storage.mjs`
- `skill/scripts/detect-csp.mjs`
- `skill/scripts/doctor.mjs`
- `skill/scripts/hook-before-edit.mjs`
- `skill/scripts/hook-lib.mjs`
- `skill/scripts/hook.mjs`
- `skill/scripts/lib/artifact-schema.mjs`
- `skill/scripts/lib/design-parser.mjs`
- `skill/scripts/lib/impeccable-paths.mjs`
- `skill/scripts/lib/provider.mjs`
- `skill/scripts/lib/staleness-deep.mjs`
- `skill/scripts/lib/staleness-notice.mjs`
- `skill/scripts/lib/staleness.mjs`
- `skill/scripts/lib/surface-briefs.mjs`
- `skill/scripts/live-accept.mjs`
- `skill/scripts/live-server.mjs`
- `skill/scripts/live-wrap.mjs`
- `skill/scripts/live.mjs`
- `skill/scripts/live/frameworks/index.mjs`
- `skill/scripts/live/frameworks/nextjs.mjs`
- `skill/scripts/live/frameworks/sveltekit.mjs`
- `skill/scripts/live/roots.mjs`
- `skill/scripts/pin.mjs`
- `skill/SKILL.src.md`
- `tests/build.test.js`
- `tests/cli-ignores.test.js`
- `tests/detect-antipatterns-fixtures.test.mjs`
- `tests/doctor.test.mjs`
- `tests/framework-fixtures/README.md`
- `tests/inline-ignores.test.mjs`
- `tests/lib/impeccable-config.test.js`
- `tests/live-e2e.test.mjs`
- `tests/pin.test.mjs`
- `tests/skill-behavior/README.md`
- `tests/staleness.test.mjs`