docs: add proof-first launch checklist

[mohanagy]

Summary

• add a public docs/launch-checklist.md template for proof-first launch/distribution work, including a required proof block, explicit channel tracker, and a benchmark-backed launch draft anchored to Build a multi-repo benchmark suite for adoption proof #469
• link the launch checklist from README/release docs and add Create a public distribution and launch checklist for adoption channels #474 to the public roadmap so the release/distribution guidance is discoverable
• add docs regressions that lock the launch checklist contract, roadmap entry, and benchmark-backed guardrails against generic launch copy

Test Plan

• npm run typecheck
• npm run build
• CI=1 npm run test:run

Refs #474

Summary by CodeRabbit

• Documentation

  • Added launch checklist template for preparing public releases with proof-first requirements and channel tracking guidance
  • Updated release documentation to incorporate launch checklist steps
  • Updated roadmap to reflect v0.30 adoption and contributor experience improvements

• Tests

  • Added verification tests for launch checklist documentation

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: b16c10ac-50dc-482a-98b7-83fc88ca37fb

📥 Commits

Reviewing files that changed from the base of the PR and between 0c734b5 and 8ce1cc6.

📒 Files selected for processing (6)

• README.md
• docs/launch-checklist.md
• docs/release.md
• docs/roadmap.md
• tests/unit/launch-checklist-doc.test.ts
• tests/unit/roadmap-docs.test.ts

---

📝 Walkthrough

Walkthrough

This PR introduces a reusable launch checklist template (docs/launch-checklist.md) for proof-first releases and adoption announcements, integrates it into the user-facing documentation and release process across README, release checklist, and roadmap, and adds validation tests to ensure the template structure and cross-references are maintained.

Changes

Launch Checklist Feature

Layer / File(s)	Summary
Launch checklist template docs/launch-checklist.md	Defines a proof block structure, channel-by-channel tracker table for update/proof/caveat status, guidance for drafting benchmark-backed launch posts (with issue #469 reference and bundle paths), and messaging guardrails.
User-facing documentation and roadmap updates README.md, docs/roadmap.md, docs/release.md	README adds launch checklist links to install details and "What's New" sections; roadmap documents issue #474 for proof-first release checklist; release.md integrates checklist requirements into pre-release, pre-posting, and post-release steps.
Documentation structure and cross-reference validation tests/unit/launch-checklist-doc.test.ts, tests/unit/roadmap-docs.test.ts	New and updated tests verify launch checklist structure (proof block, channel tracker, benchmark draft details), confirm the checklist is linked from README and release.md, and assert roadmap includes issue #474 and launch checklist reference.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related issues

• Create a public distribution and launch checklist for adoption channels #474: This PR directly implements the proof-first release checklist with explicit launch checklist, channel tracking, and benchmark-backed launch drafts that were requested in the issue.

Possibly related PRs

• mohanagy/madar#485: Both PRs update docs/roadmap.md and tests/unit/roadmap-docs.test.ts to add new issue-based roadmap item assertions.
• mohanagy/madar#459: Both PRs modify the same roadmap documentation and test surfaces by adding new roadmap assertions.

Poem

🐰 A checklist is born, all proof-first and true,
With benchmarks and channels to guide what's new,
From README to release, the threads now align—
A hop toward launches that sparkle and shine! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'docs: add proof-first launch checklist' clearly and concisely summarizes the main change: adding a new documentation template for proof-first launch workflows.
Description check	✅ Passed	The description covers the key changes (new template, linking from docs, regression tests) and includes a comprehensive test plan with all three verification steps checked, but the Testing section formatting does not exactly match the template structure.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch issue-474-distribution-launch-checklist

---

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