[owieschon]

What & why

Adds one docs page: docs/proof-gate-needs-review-receipt.md.

Needs review on the board is not shipped. Tip-native proof (check runs or a receipt pinned to the exact branch-tip SHA) is required first. Without that bar, Operators treat chrome as done and the product keeps lying about finished work.

How I tested it

• Docs-only diff vs upstream main (single file) — branch cut from superset-sh/superset tip, not fork-main drift
• Stay DRAFT — no undraft without CoS→Owen

Checklist

• Thin docs brick only (no host-service / product code)
• Attested board nouns; no invented ReadyVerified column
• Fence Todd feat(sdk): expose terminal agent lifecycle status #7007 agentStatus SoT; no hooks fix(agent-setup): preserve Cursor identity through tool execution #7252/fix(agent-setup): preserve agent identity and enable OpenCode session resume #7263

Supersedes #7296/#7297 (those heads sat on fork-main commits not yet in upstream).

---

Summary by cubic

Adds a docs page establishing that a workspace in Needs review is not shipped: operators must first see tip-native proof, either CI check runs or a receipt pinned to the exact branch-tip SHA.

This is a draft docs-only rule; it does not change product behavior, board columns, or agentStatus.

^{Written for commit f421563. Summary will update on new commits.}

Mechanism

Docs-only operator recipe. One page states that Needs review is a board column meaning needs review — not shipped — until a tip-native proof artifact (check runs or receipt) is pinned to the exact branch-tip SHA. No new columns, no host-service code, no agentStatus SoT changes (Todd #7007).

Session: OpenCode Alibaba overnight proof-gate → thin re-cut from upstream/main as docs/proof-gate-thin-upstream after fork-main drift closed #7296/#7297.

How I tested it

• RECEIPT_PATH=/workspace/handoffs/pr7298-receipt-f42156340.md
• Tip: f42156340fbdd528efa6b316e5793aee5b2270d5
• Fork tip-match (authoritative Partial db setup #34 only): CI tip-match: #7298 docs proof-gate (Needs review) owieschon/superset#34
• Fork CI: https://github.com/owieschon/superset/actions/runs/34185079885 — owned jobs SUCCESS (Lint/Test/Typecheck/Build/Sherif/Vale/Version Sync/Build CLI×4); Neon allowlist OK
• Docs self-check: single-file tip vs upstream/main; recipe asserts Needs review ≠ shipped
• Stay DRAFT — no undraft without CoS→Owen

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[owieschon]

Closing — this was internal operator practice, not an upstream product change. Keeping the bar in private doctrine; will land trust work as product behavior instead.