← ClaudeAtlas

compass-visuallisted

Render a build's Contract Brief and progress Cockpit as self-contained HTML + a PNG — the visual "what we're building" and "where it stands" surfaces of a Compass build. The Brief is a cinematic-hero cover + rk-house-style body, read as a PURE FUNCTION of contract.md; the Cockpit is the stage timeline + step k/n + blocker + what's next + what the reviews caught, from progress.md/plan.md/receipts.md/review-ledger.md. Trigger at contract closure (produce the Brief before the explicit lock), at any point someone asks "show me where this build stands", or when the Compass contract/build stages need the visual. A shareable Artifact is produced ONLY on request — and the user is told that option exists.
Rishi4792/compass · ★ 2 · AI & Automation · score 75
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.