Versioning & releases pilot
Ship the first Operate slice that proves deep-embed with receipts. Draft the page skeleton or Run the annex lab. Exit metric: annex lab pass rate ≥ 0.9 with receipts and state snapshot logged under v2025.11-releases.
Tiny receipts — Releases (v2025.11)
- m-lab-pass: 0.92 across versioning & releases pilot runs
- m-defect-rate-changed-pages: 0.02 for touched Operate assets See the receipts
Why this slice exists
- Proof over promise — We need one Operate page that shows opener pattern, telemetry, annex lab, and receipts before cloning the approach.
- Reversible by default — Two CTAs (“Draft the skeleton” / “Run the lab”) keep changes testable; any override is logged at L3 with expiry.
- Traceable — Readers can walk
decision → guardrail → page → annex lab → receiptswithout leaving the seam.
Ship the page
- Hold the opener pattern — One-sentence “why,” two reversible CTAs, and an exit metric must render above the first heading.
pnpm run ux:scanverifies the fold. - Embed the contract — Frontmatter includes
bucket,north_star_id,guardrail_id, metrics, anddecision_link.pnpm run frontmatter:lintblocks gaps. - Surface receipts inline — Tiny receipts panel links to
/signals/receipts/v2025.11-releases.mdand states the guardrail budget (0.9 lab pass, ≤0.05 defects). - Keep copy within ~600 px — Readers should see the why, two actions, exit metric, and receipts without scrolling.
Wire telemetry & traceability
- Signals — Both CTAs map to
m-lab-pass(leading) andm-defect-rate-changed-pages(lagging).pnpm run traceability:checkenforces the link between CTAs, signals, and receipts. - Labs —
pnpm run labsexecutes the annex config (labs/versioning-and-releases.lab.json) and records output inreports/labs.json. - Receipts + state — Update
/signals/receipts/v2025.11-releases.mdand/releases/state/v2025.11-releases.mdafter every run so adoption/quality/credibility stay fresh. - CI budget — Guardrails stay nudges unless sanitation or traceability fails. Lab runtime ≤10 minutes keeps the seam within the release budget.
Publish receipts & exit criteria
- Attach the latest
reports/labs.jsonexcerpt plus analytics snapshot for the slice to the PR. - Add a short adoption/quality/credibility note to
docs/signals/receipts/v2025.11-releases.md. - Update the release bundle (
ops/releases/2025-11/index.md) and state snapshot (/releases/state/v2025.11-releases.md) so auditors can trace the pilot. - Freeze the slice if pass rate drops below 0.80 or if two L3 overrides occur during the window; resume only after receipts recover for one full tag.

