Skip to content
Owner: @lop • live

Run this checklist in ≤10 minutes after reading the Verify-in-10 guide. Run the lab or Log your receipts. Exit metric: dashboards refresh within 30 days and decision hit rate stays ≥ 60%.

Tiny receipts — Learn (v2025.11)

Preconditions

  • SLI stage and guardrail mapping logged (or exception ID ready).
  • pnpm install and pnpm run docs:guard available locally.
  • Latest manifest file (ops/releases/YYYY-MM/manifest.json) checked out.

Steps (≤10 minutes)

  1. Scope check (1 min) — Confirm SLI stage + guardrail ID (or exception). Update manifest decisions if needed.
  2. Fold rules (2 min) — Verify opener + CTAs render above the first section and the Verify guide link is visible when required.
  3. Tests + labs (3 min) — Run pnpm run docs:guard (or targeted labs). Capture the first successful output for receipts.
  4. Receipts + snapshot (2 min) — Refresh analytics snapshot (pnpm run analytics:snapshot) if adoption data changed.
  5. State build (2 min) — Edit manifest metrics, run pnpm run state:build, stage ops/releases/YYYY-MM/index.md + do../navigate/state-ledger.md.

Acceptance checks

  • Guardrail mapping or exception recorded.
  • CTA fold rules pass; Verify link visible when required.
  • pnpm run docs:guard exits 0; logs attached to PR.
  • Manifest metrics updated; pnpm run state:build rerun; outputs staged.
  • Receipts (manifest + snapshot) referenced in PR or release notes.

Rollback / stop rule

  • If any step fails twice, stop and fix the underlying issue (CTA contract, tests, manifest). Don’t ship until the lab runs clean in ≤10 minutes.
  • If the lab consistently exceeds 10 minutes, roll back the last checklist addition and file a kl,question issue with the failing step.

Text © CC BY-NC 4.0 • Code samples MIT • Views are my own.