impeccable 4.1.0 → 4.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -3
- package/README.npm.md +3 -3
- package/README.repo.md +26 -26
- package/package.json +9 -8
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable CLI
|
|
2
2
|
|
|
3
|
-
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for
|
|
3
|
+
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 59 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
|
|
4
4
|
|
|
5
5
|
The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
|
|
6
6
|
|
|
@@ -57,7 +57,7 @@ npx impeccable detect --json src/
|
|
|
57
57
|
|
|
58
58
|
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
59 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
|
|
61
61
|
|
|
62
62
|
## Exit Codes
|
|
63
63
|
|
|
@@ -87,7 +87,7 @@ Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/
|
|
|
87
87
|
|
|
88
88
|
## Part of Impeccable
|
|
89
89
|
|
|
90
|
-
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes
|
|
90
|
+
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 24 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
|
|
91
91
|
|
|
92
92
|
## License
|
|
93
93
|
|
package/README.npm.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable CLI
|
|
2
2
|
|
|
3
|
-
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for
|
|
3
|
+
Detect UI anti-patterns and design quality issues from the command line, and install the Impeccable design skill into your AI coding harness. The detector scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 59 deterministic rules, including AI-generated UI tells, accessibility violations, and general design quality problems.
|
|
4
4
|
|
|
5
5
|
The npm package is a small launcher. It runs the `impeccable` engine binary for your platform, installed alongside it as an optional dependency (`@impeccable/cli-<os>-<arch>`), and falls back to a per-user cache or a one-time download when that package is missing.
|
|
6
6
|
|
|
@@ -57,7 +57,7 @@ npx impeccable detect --json src/
|
|
|
57
57
|
|
|
58
58
|
**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
59 deterministic detector rules in total. See the full catalog at [impeccable.style/slop](https://impeccable.style/slop).
|
|
61
61
|
|
|
62
62
|
## Exit Codes
|
|
63
63
|
|
|
@@ -87,7 +87,7 @@ Binary lookup order: `IMPECCABLE_BIN`, the platform package, `~/.impeccable/bin/
|
|
|
87
87
|
|
|
88
88
|
## Part of Impeccable
|
|
89
89
|
|
|
90
|
-
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes
|
|
90
|
+
This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 24 commands for Claude, Cursor, GitHub Copilot, Gemini, Codex, Hermes Agent, Veto, and more.
|
|
91
91
|
|
|
92
92
|
## License
|
|
93
93
|
|
package/README.repo.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable
|
|
2
2
|
|
|
3
|
-
Design guidance for AI coding agents. 1 skill,
|
|
3
|
+
Design guidance for AI coding agents. 1 skill, 24 commands, live browser iteration, and 59 deterministic detector rules for AI-generated frontend design.
|
|
4
4
|
|
|
5
5
|
> **Quick start:** From your project root, run `npx impeccable install`, then run `/impeccable init` inside your AI coding tool. Full docs: [impeccable.style](https://impeccable.style).
|
|
6
6
|
|
|
@@ -12,8 +12,8 @@ Every model trained on the same SaaS templates. Skip the guidance and you get th
|
|
|
12
12
|
|
|
13
13
|
Impeccable adds:
|
|
14
14
|
- **One setup flow.** `/impeccable init` records durable product truth in `PRODUCT.md`, so later commands know the audience, purpose, operating context, constraints, voice, and evidence without confusing those facts with surface-level visual direction.
|
|
15
|
-
- **
|
|
16
|
-
- **
|
|
15
|
+
- **24 commands.** A shared design vocabulary with your AI: `polish`, `audit`, `critique`, `distill`, `animate`, `bolder`, `quieter`, and more.
|
|
16
|
+
- **59 deterministic detector rules** plus LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key.
|
|
17
17
|
|
|
18
18
|
## What's Included
|
|
19
19
|
|
|
@@ -33,7 +33,7 @@ Start every new project with:
|
|
|
33
33
|
|
|
34
34
|
`init` inspects the project, asks only for material gaps in durable product truth, and writes `PRODUCT.md`. Visitor mode and visual direction are chosen later for each surface; incumbent or newly built visual systems are recorded separately in `DESIGN.md`.
|
|
35
35
|
|
|
36
|
-
###
|
|
36
|
+
### 24 Commands
|
|
37
37
|
|
|
38
38
|
All commands are accessed through `/impeccable`:
|
|
39
39
|
|
|
@@ -62,6 +62,7 @@ All commands are accessed through `/impeccable`:
|
|
|
62
62
|
| `/impeccable adapt` | Adapt for different devices |
|
|
63
63
|
| `/impeccable optimize` | Performance improvements |
|
|
64
64
|
| `/impeccable live` | Visual variant mode: iterate on elements in the browser |
|
|
65
|
+
| `/impeccable generate` | Generate variants of a named element in the live browser, no manual picking |
|
|
65
66
|
|
|
66
67
|
Use `/impeccable pin <command>` to create standalone shortcuts (e.g., `pin audit` creates `/audit`).
|
|
67
68
|
|
|
@@ -357,31 +358,30 @@ As you run commands, Impeccable writes working files under `.impeccable/`: criti
|
|
|
357
358
|
```gitignore
|
|
358
359
|
# impeccable-ignore-start
|
|
359
360
|
# Ephemeral output, runtime state, and per-dev overrides.
|
|
360
|
-
#
|
|
361
|
-
# workspace (apps/web/.impeccable/...); anchored patterns would miss it.
|
|
361
|
+
# The **/ prefix covers .impeccable at the repo root or in a nested workspace.
|
|
362
362
|
# Shared artifacts stay tracked: config.json, live/config.json,
|
|
363
363
|
# design.json, surfaces/*.md, critique/*.md.
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
364
|
+
**/.impeccable/config.local.json
|
|
365
|
+
**/.impeccable/hook.cache.json
|
|
366
|
+
**/.impeccable/hook.pending.json
|
|
367
|
+
**/.impeccable/*.png
|
|
368
|
+
**/.impeccable/review/
|
|
369
|
+
**/.impeccable/questions/
|
|
370
|
+
**/.impeccable/live/server.json
|
|
371
|
+
**/.impeccable/live/sessions/
|
|
372
|
+
**/.impeccable/live/previews/
|
|
373
|
+
**/.impeccable/live/annotations/
|
|
374
|
+
**/.impeccable/live/cache/
|
|
375
|
+
**/.impeccable/live/manual-edit-apply-transaction.json
|
|
376
|
+
**/.impeccable/live/manual-edit-events.jsonl
|
|
377
|
+
**/.impeccable/live/manual-edit-evidence/
|
|
378
|
+
**/.impeccable/live/pending-manual-edits.json
|
|
379
|
+
**/.impeccable/live/deferred-svelte-component-accepts.json
|
|
380
|
+
**/.impeccable/live/*.png
|
|
381
381
|
# impeccable-ignore-end
|
|
382
382
|
```
|
|
383
383
|
|
|
384
|
-
The block is wrapped in `# impeccable-ignore-start` / `# impeccable-ignore-end` markers so you can recognize and refresh it later.
|
|
384
|
+
The block is wrapped in `# impeccable-ignore-start` / `# impeccable-ignore-end` markers so you can recognize and refresh it later. The `**/` prefix makes each pattern match whether the active project's `.impeccable/` directory is at the repository root or under a nested workspace path like `apps/web/`.
|
|
385
385
|
|
|
386
386
|
**Keep these tracked** (they are shared project artifacts, do not add them to `.gitignore`):
|
|
387
387
|
|
|
@@ -417,7 +417,7 @@ For debugging, set `hook.auditLog` in `.impeccable/config.json` to a path (or th
|
|
|
417
417
|
|
|
418
418
|
## Build path: comp-first or code-first
|
|
419
419
|
|
|
420
|
-
When a new surface gets designed, Impeccable either generates a full-fidelity comp first and builds to match it, or builds straight in code with the ambition written into a development-only direction contract in the surface brief and checked at the finish. Comp-first composes bolder and takes longer; code-first is leaner and faster. `/impeccable init` asks once and records the answer as `buildPath` in `.impeccable/config.json`:
|
|
420
|
+
When a new surface gets designed, Impeccable either generates a full-fidelity comp first and builds to match it, or builds straight in code with the ambition written into a development-only direction contract in the surface brief and checked at the finish. Comp-first composes bolder and takes longer; code-first is leaner and faster. The choice covers landing pages and showcase surfaces. App screens and documents are built code-first either way, because they come out better built than pictured. `/impeccable init` asks once and records the answer as `buildPath` in `.impeccable/config.json`:
|
|
421
421
|
|
|
422
422
|
```json
|
|
423
423
|
{ "buildPath": "comp" }
|
|
@@ -463,7 +463,7 @@ npx impeccable ignores add-file "src/legacy/**"
|
|
|
463
463
|
npx impeccable ignores add-value overused-font Inter --reason "Brand font"
|
|
464
464
|
```
|
|
465
465
|
|
|
466
|
-
The detector catches
|
|
466
|
+
The detector catches 59 deterministic issues across AI slop (side-tab borders, purple gradients, bounce easing, dark glows) and general design quality (line length, cramped padding, small touch targets, skipped headings, and more).
|
|
467
467
|
|
|
468
468
|
Human-readable findings are diagnostics written to stderr, so redirect them with `2> findings.txt`. Use `--json` for machine-readable results on stdout. Exit `0` means the scan completed without primary findings, exit `2` means it completed with primary findings, and exit `1` means at least one requested target could not be scanned; operational failure takes precedence for a partial multi-target scan. URL scans inspect the rendered DOM, computed layout, and accessible linked stylesheets; browser security still prevents reading cross-origin CSS without CORS. A clean detector run is evidence, not proof of visual or accessibility quality: it does not replace inspecting the rendered experience across relevant viewports.
|
|
469
469
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "4.1
|
|
3
|
+
"version": "4.5.1",
|
|
4
4
|
"author": "Paul Bakaus",
|
|
5
5
|
"description": "Design skills, commands, and anti-pattern detection for AI coding agents",
|
|
6
6
|
"keywords": [
|
|
@@ -70,21 +70,22 @@
|
|
|
70
70
|
"release:ext": "node scripts/release.mjs extension",
|
|
71
71
|
"release:engine": "node scripts/release.mjs engine",
|
|
72
72
|
"release:platform-packages": "node scripts/publish-platform-packages.mjs",
|
|
73
|
-
"check:engine-release": "node scripts/check-engine-release.mjs"
|
|
73
|
+
"check:engine-release": "node scripts/check-engine-release.mjs",
|
|
74
|
+
"build:component-review": "bun scripts/build-component-review.mjs"
|
|
74
75
|
},
|
|
75
76
|
"optionalDependencies": {
|
|
76
|
-
"@impeccable/cli-darwin-arm64": "0.1.
|
|
77
|
-
"@impeccable/cli-darwin-x64": "0.1.
|
|
78
|
-
"@impeccable/cli-linux-x64": "0.1.
|
|
79
|
-
"@impeccable/cli-linux-arm64": "0.1.
|
|
80
|
-
"@impeccable/cli-windows-x64": "0.1.
|
|
77
|
+
"@impeccable/cli-darwin-arm64": "0.1.12",
|
|
78
|
+
"@impeccable/cli-darwin-x64": "0.1.12",
|
|
79
|
+
"@impeccable/cli-linux-x64": "0.1.12",
|
|
80
|
+
"@impeccable/cli-linux-arm64": "0.1.12",
|
|
81
|
+
"@impeccable/cli-windows-x64": "0.1.12"
|
|
81
82
|
},
|
|
82
83
|
"devDependencies": {
|
|
83
84
|
"@ai-sdk/anthropic": "^4.0.7",
|
|
84
85
|
"@ai-sdk/google": "^4.0.8",
|
|
85
86
|
"@ai-sdk/openai": "^4.0.7",
|
|
86
87
|
"@anthropic-ai/claude-agent-sdk": "^0.3.165",
|
|
87
|
-
"@anthropic-ai/sdk": "^0.
|
|
88
|
+
"@anthropic-ai/sdk": "^0.131.0",
|
|
88
89
|
"@babel/parser": "^8.0.4",
|
|
89
90
|
"ai": "^7.0.14",
|
|
90
91
|
"archiver": "^8.0.0",
|