Skip to content

Streamline demo to run-first, remove judge-facing copy, and clarify verification path#53

Open
GsCommand wants to merge 1 commit intomainfrom
codex/fix-judge-perception-issues-across-repo
Open

Streamline demo to run-first, remove judge-facing copy, and clarify verification path#53
GsCommand wants to merge 1 commit intomainfrom
codex/fix-judge-perception-issues-across-repo

Conversation

@GsCommand
Copy link
Contributor

Motivation

  • Public-facing pages contained judge/evaluator-focused copy and a multi-step demo chooser that made the site feel staged for judging instead of a real product, which undermines trust and raises demo friction.
  • The demo flow explained concepts before producing the strongest proof moment, creating unnecessary decision points before a visitor can see a receipt and verification.
  • The visible verification surface did not make the signer → public-key → ENS resolution path concrete enough for technical verification, lowering confidence in the claim that receipts are verifiable.

Description

  • Removed and replaced judge/evaluator phrasing across the public site with product-truth language such as "What this proves quickly", "Proof flow", and "Why this matters" and other neutral audience wording (changed strings on public/index.html, public/demo.html, public/composer.html, public/demo-inner.html, public/quickstart.html, public/runtime.html, public/commons.html, public/repositories.html, and public/licensing.html).
  • Simplified the demo entry path so CTAs now route to the runnable Composer surface (composer.html?autorun=1) and added an autorun hook in Composer so the primary flow is executed immediately when appropriate, converting the experience to click → run → receipt → verify.
  • Reduced pre-proof friction by collapsing customization behind an Advanced flow options disclosure on public/composer.html and keeping the strongest default flow preloaded and prominent.
  • Made the verification path materially clearer by adding a dedicated "Verification path" section and new UI metrics and IDs (metric-signer-identity, metric-signature-algorithm, metric-key-source, metric-verification-route, verification-path-tag) in public/composer.html, plus links to the Quickstart anchors that show ENS TXT records and verification material (/quickstart.html#verify and /quickstart.html#verify-material).

Testing

  • Confirmed removal of judge-facing phrases with a repository search using rg -n --hidden -S "judge|judges|judging|judge-facing|judge-readable|What a judge should understand fast" public which returned no remaining matches in public-facing files.
  • Ran content validation scripts (small Python checks) that assert the demo routing (composer.html?autorun=1), presence of the new verification UI IDs, and Quickstart verification anchors (id="verify-material" and verification path text), and all assertions passed.
  • Performed file diff and sanity inspection of the modified pages to ensure the runnable flow, autorun hook (autorun=1), and verification copy were inserted as intended; no browser/screenshot validations were run in this environment.

Codex Task

@vercel
Copy link

vercel bot commented Mar 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
commandlayer-commandlayer-org Ready Ready Preview, Comment Mar 19, 2026 4:43am
commandlayer-org Ready Ready Preview, Comment Mar 19, 2026 4:43am
commandlayer-org111 Ready Ready Preview, Comment Mar 19, 2026 4:43am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant