witness-designlisted
Install: claude install-skill popovych-co/witness
# witness-design — spec → approved look → gate
<!-- Adapted: process from benoticed docs/ui/redesign-method.md (context phase →
2-3 distinct directions → converge → change-ladder), generalized to two modes and
re-owned for witness; greenfield direction informed by Anthropic frontend-design
(Apache-2.0, LICENSES/frontend-design-Apache-2.0.txt, changes stated in NOTICE.md).
No text copied verbatim; the design-critic lens is new material. -->
## Ground rules (every witness skill)
Resolve the CLI once per session:
```bash
WITNESS="${WITNESS_BIN:-npx -y @popovych.co/witness@0.10.1}"
```
- **Never edit `specs/**`, `plans/**`, or `designs/**`** — the CLI is the sole writer of state. Author HTML in `$(mktemp -d)` and hand it to `witness design`. (The canon guard blocks direct edits; the trailer audit catches end-runs.)
- **Never invoke gate reviewers or relay verdicts.** `witness gate design` runs the design-critic itself and journals what it said.
- **Refusal repair loop:** `witness design` exiting 2 prints structured violations (`field · rule · got · want`). Fix and retry — **3 total attempts**, then stop and show the human the list verbatim.
- **A refused or hook-blocked command is a stop, not a step to drop.** Re-issue it on its own; if it still refuses, tell the human what was blocked and why. Never proceed by deleting the refused half of a compound command — a dropped step is silent, and silence is how a skipped check becomes a shipped defect.
- **Re-entrancy:** derive pos