design-prooflisted
Install: claude install-skill HKamkar/agentic-cms
# Design proof
The harness is `agentic-cms visual-parity` (`docs/visual-parity.md` of the
kit — the modes, the file names, the waits, the traps — and
`docs/commands.md` for the flags). A proof is two captures and one compare;
the compare's report says what moved, where, and whether the rest of the
page survived.
## Read first
`docs/visual-parity.md` § Reading a compare; the change's diff (`git diff
develop --stat`) to know which pages and sections it can touch; whether
anything animates (`grep -rl "agentic-cms/ix" src/components`), which
decides whether `--motion` is part of the proof.
## Steps
1. **The baseline**, from the exact commit the change starts from, never
from a checkout that moved on:
```bash
pnpm kit visual-parity capture before --ref develop # or the branch's base commit; its demo routes are left out
```
(A served build standing in for a commit — `--url` — has its `git log
-1` printed first.) With reveals in use, also `--motion`; with hover,
focus, checked or open states touched, also `--states`; with a dark
theme, `--scheme dark`. A long run goes in the background; the capture is
finished when `.parity/visual/<label>/capture.json` exists.
2. **The change**, built exactly as it will be committed (`pnpm build`;
nothing edited after it), then:
```bash
pnpm kit visual-parity capture after
pnpm kit visual-parity compare before after --json
```
`--pages /a,/b` on both while iterating on one page; the fu