Skip to content

docs(readme): launch-funnel pass with evidence table, comparison, and FAQ - #410

Merged
abrichr merged 1 commit into
mainfrom
docs/readme-launch-funnel
Aug 26, 2026
Merged

docs(readme): launch-funnel pass with evidence table, comparison, and FAQ#410
abrichr merged 1 commit into
mainfrom
docs/readme-launch-funnel

Conversation

@abrichr

@abrichr abrichr commented Aug 26, 2026

Copy link
Copy Markdown
Member

Launch-funnel edit of the Show HN link target, applying the workspace writing guides with minimum effective edits, plus the calibration additions.

Additions

  • GitHub-stars badge pointing at the flagship OpenAdaptAI/OpenAdapt repo, labeled as such.
  • Quick-links row under the badges: no-install browser demo, website, docs, Discussions, contributing. All five URLs return 200.
  • Audited evidence table in the first screen-and-a-half. Numbers copied from the claims registry and the existing Benchmark section: OpenEMR 19/20 effect-verified at 39.2s median (run 20 was a safe halt) vs agent 10/10 at 70.4s median, ~$0.55/run; MockMed 100/100 at 4.9s p50 vs 20/20 at 37.5s p50, ~$0.27/run. Both rows link their method files.
  • The existing how-it-works Mermaid now shows independent verification with VERIFIED and HALT terminals, and its text summary matches.
  • A condensed agents-vs-RPA comparison table, sourced from the site's /compare data; links to the sourced comparisons.
  • A five-question FAQ seeded from the launch reply prep: agents, RPA, failure behavior, secrets/PHI, production readiness (admission-derived wording, no static lifecycle label).
  • No Python API snippet: the package exports IR types only, so the honest programmatic surface is the CLI. Skipped rather than faked.

Copy fixes

  • Rewrote the four-em-dash evidence-splits paragraph as plain sentences.
  • "A workflow program, not just a line of steps" -> "A workflow program."
  • "the story isn't success rate. It's that..." -> states the cost/latency difference directly.
  • Dropped "honestly" from the substrate-evidence lead-in.

Gates

  • python scripts/check_consistency.py passes locally (paths, banned phrases, lifecycle labels, no test count).
  • python scripts/validate_claims.py --structure-only passes; no claim text or number changed.
  • ci.yml untouched, so the public-artifacts hash pin is unaffected.

🤖 Generated with Claude Code

…uick links

Add a stars badge (flagship OpenAdapt repo, labeled), a quick-links row with a
no-install browser demo link, an audited two-row evidence table above the fold,
independent verification and VERIFIED/HALT terminals in the how-it-works
diagram, a condensed agents-vs-RPA comparison sourced from the site's compare
pages, and a five-question FAQ for launch-thread objections.

Copy pass per the writing guides: remove one em-dash cluster, a 'not just'
contrast, a 'story isn't X, it's Y' scaffold, and 'honestly'. All numbers
unchanged; check_consistency.py and validate_claims.py --structure-only pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@abrichr
abrichr merged commit 977dd4c into main Aug 26, 2026
15 checks passed
@abrichr
abrichr deleted the docs/readme-launch-funnel branch August 26, 2026 21:07
abrichr added a commit that referenced this pull request Aug 26, 2026
…#411)

The README ran ~8,055 words. The launch elements added in #410 (badges,
quick-links row, evidence table, mermaid flow, comparison block, FAQ) were
buried under reference material that belongs in the docs tree.

This moves the reference material out and leaves a linear read of ~2,580
words: what it is, the demo, the evidence table, try it, how it works, proof,
record your own app, what else it does, the comparison, the benchmark
headline, product state, local-first, FAQ.

No information is removed. Every relocated section keeps a specific bridging
link from the README, and each moved fact is one click away.

New pages:

  docs/TUTORIAL.md                  tutorial / --break-it / --guided, the
                                    hand-driven stages, packaging + browser
                                    provisioning
  docs/PARAMETERS.md                parameter proposals, profile selection,
                                    the transaction_outcome enum, lint/certify
  docs/SECRETS_AND_EVIDENCE.md      page-local secrets, identity vs reflected
                                    evidence, URL structure reduction
  docs/RECEIPTS.md                  the closed allow-list receipt contract
  docs/CAPABILITIES.md              from trace to program, answer a halt from
                                    a phone
  docs/BENCHMARKS.md                OpenEMR, MockMed, Frappe lending,
                                    EffectBench: full method and caveats
  docs/HOSTED.md                    local-first posture, seal, cloud
                                    connectivity and its boundary rules
  docs/CLAIMS_AND_QUALIFICATION.md  the two admissions, what is qualified,
                                    machine-checked claims
  docs/RESOLUTION_LADDER.md         rung-by-rung detail, vision-first framing,
                                    armed-step coverage

Extended in place:

  docs/SURFACES.md                  execution-boundary table, per-substrate
                                    evidence matrix, what record observes,
                                    browser attach mode
  docs/VISUALIZE.md                 the emitted MockMed mermaid and how to
                                    read its target labels

Preserved exactly: every number and its framing (19/20 stays 19/20 with the
safe-halt note), the #410 launch elements, and the claims-gate surface.
check_consistency, check_bundle_phi, validate_claims --structure-only, and
tests/test_consistency.py all pass; every relative link in the README and in
the new pages resolves.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant