docs(recipe): worked example for tip-native proof before shipped
Draft
OW
2mo ago+25+25+01234567890123456789-0-0-0123456789
What & why
Adds docs/proof-gate-worked-example.md — a companion to the Needs review proof-gate recipe.
Operators still treat board chrome as done. This page shows the tip-SHA + receipt + fork CI pattern so Needs review cannot be read as shipped without tip-native proof. Matters for anyone merging overnight honesty bricks; keeps the hire-line invariant teachable without inventing a new column.
How I tested it
- Docs-only diff vs upstream
main(single file) - Cut from upstream/main (no fork-main drift)
- Stay DRAFT — no undraft without CoS→Owen
Mechanism
Docs-only. No product code. Lexicon: Needs review / tip-native proof / receipt — no ReadyVerified column. Fence Todd #7007 agentStatus SoT; no hooks; no dock #6506.
Checklist
- Single docs file vs upstream main
- Companion to proof-gate-needs-review-receipt recipe
- Stay DRAFT until CoS READY + Owen undraft
How I tested it
- RECEIPT_PATH=
/workspace/handoffs/pr7302-receipt-59e373fd3.md - Tip:
59e373fd3fa81feb6d0bb0f3a54c424a2ca74cc1 - Fork tip-match (authoritative #35 only): https://github.com/owieschon/superset/pull/35 @
59e373fd3 - Fork CI: https://github.com/owieschon/superset/actions/runs/34185762012 — owned jobs SUCCESS (Lint/Test/Typecheck/Build/Sherif/Vale/Version Sync/Build CLI×4); Neon Deploy Database FAIL allowlisted
- Docs self-check: single-file tip vs upstream/main
- Stay DRAFT
Summary by cubic
Adds a docs-only worked example for the proof-gate recipe, showing how tip-SHA plus receipt plus fork CI proves a change is testable at the branch tip before it can be treated as shipped.
New Features
- Documents the 5-step proof pattern: record tip SHA, run the focused test at that tip, keep a receipt with Overall: PASS, cite the receipt and fork CI URL in the PR body, and stay draft until that proof exists.
- States explicitly that board Needs review does not waive the proof requirement, and that this is not a new column, not a second
agentStatussource of truth, and not a substitute for maintainer review. - Stays DRAFT until CoS gives READY and Owen undrafts.