← ClaudeAtlas

witness-planlisted

Derive an implementation plan from a witness spec's delta — step manifest mapping criteria, write-validated
popovych-co/witness · ★ 1 · AI & Automation · score 74
Install: claude install-skill popovych-co/witness
# witness-plan — spec delta → step plan → gate <!-- Derived (MIT): plan discipline from obra/superpowers writing-plans (exact files, bite-sized verifiable steps). Rewritten for witness: the plan derives from a CLI-computed delta and its steps are schema'd against the parent's criteria. See NOTICE.md. --> ## 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/**` or `plans/**`** (the canon dirs — `paths:` in witness.config.yaml may relocate them) — not with an edit tool, not with a write tool, not with Bash redirection. The CLI is the sole writer of state; you author in scratch files under `$(mktemp -d)` and hand them to the CLI. (The canon guard blocks you; the trailer audit catches what it can't.) - **Never invoke gate reviewers or relay verdicts.** `witness gate` runs reviewers itself and journals what they said; your summary of a verdict is not evidence. - **Refusal repair loop:** a `witness` verb exiting 2 prints structured violations (`field · rule · got · want`). Fix your input and retry — **3 total attempts** per artifact, then stop, show the human the violation list verbatim, and end your turn. - **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 i