compass-visuallisted
Install: claude install-skill Rishi4792/compass
# compass-visual
Two views of a build, generated deterministically from its on-disk state by `gen.mjs`.
- **Contract Brief** — *what we're building.* A cinematic-hero cover (its own accent + grade) over an rk-house-style body: the goal, what it touches, the reconciliation gold, the invariants, the NOW/LATER/NEVER scope, and the security classification. A pure function of `contract.md`.
- **Cockpit** — *where it stands.* Stage timeline (done / ◉ here / left), step k/n, the next action, and what the reviews caught. From `progress.md` / `plan.md` / `receipts.md` / `review-ledger.md`.
Both are **self-contained HTML** written into the build folder, rendered to **PNG** via `cinematic-hero/render.sh`. Same state → byte-identical HTML (no clock, no randomness) — safe to re-run.
## Generate
```
node skills/compass-visual/gen.mjs <build-dir> <view> [--shareable] [--out <file>]
```
- `view` ∈ `brief` | `brief-body` | `cockpit`.
- `brief` — the full page: cinematic cover + house body. This is what you render + show.
- `brief-body` — ONLY the house-style body region. This is the artifact the house gates run on (the cinematic cover is off-theme **by design** and is excluded from the gate — it follows cinematic-hero's own accent + editorial radii).
- `cockpit` — the progress view.
- `--out <file>` writes to a file; without it, HTML goes to stdout (so `diff <(gen …) <(gen …)` proves idempotency exactly).
**Render to PNG** (headless Chrome):
```
bash skills/cinematic-hero/render.