docs(readme): launch-funnel pass with evidence table, comparison, and FAQ - #410
Merged
Conversation
…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
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Launch-funnel edit of the Show HN link target, applying the workspace writing guides with minimum effective edits, plus the calibration additions.
Additions
Copy fixes
Gates
python scripts/check_consistency.pypasses locally (paths, banned phrases, lifecycle labels, no test count).python scripts/validate_claims.py --structure-onlypasses; no claim text or number changed.ci.ymluntouched, so the public-artifacts hash pin is unaffected.🤖 Generated with Claude Code