Skip to content

feat(site): make /quickstart/ a Get started page for every spec - #75

Merged
imran-siddique merged 1 commit into
mainfrom
feat/get-started
Sep 14, 2026
Merged

imran-siddique merged 1 commit into
mainfrom
feat/get-started

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

agentrust-io.com/quickstart/ was the cMCP tutorial: title "cMCP Quickstart: Block a Tool Call and Verify the Receipt", eyebrow 03 · Actions. The header's Build menu, the page footers, the 404 page and llms.txt all presented it as the site's "10-minute quickstart", so a reader who wanted to start with weight custody, agent identity or evidence landed on tool-call policy. cmcp.agentrust-io.com/quickstart/ already carries the same tutorial.

What replaces it. /quickstart/ keeps its URL, which is linked widely, and becomes a short Get started page. Six cards in one grid, labelled with the homepage chain steps, link to each specification's own start page. Each card says what you do there and what it does not cover, taken from that page:

  • 01 Weights: Weight Custody Manifest, wcm.agentrust-io.com/getting-started/
  • 02 Agent: Agent Manifest, manifest.agentrust-io.com/getting-started/
  • 03 Actions: cMCP, cmcp.agentrust-io.com/quickstart/, and cA2A, ca2a.agentrust-io.com/docs/quickstart/
  • 04 Evidence: TRACE, trace.agentrust-io.com/docs/quickstart/, and the conformance suite, tests.agentrust-io.com/docs/quickstart/
  • No install: /verify/, the in-browser TDX quote check

JSON-LD changes from a HowTo to a CollectionPage listing those seven destinations.

Where the tutorial went. The cMCP docs quickstart is the one copy. The companion cmcp PR brings it to cmcp-runtime 0.5.0 and adds the CI that runs its commands, so this PR removes the quickstart job from reader-journey.yml and deletes tools/check-quickstart.py. Merge the cmcp PR first, so the published commands are never untested. The only required status check on main is gate (ruleset protect-default-branch), so removing the job does not block merges.

Links renamed

  • Build menu: "10-minute quickstart" is now "Get started", in tools/site_header.py and stamped into all 12 pages.
  • Footers: "Quickstart" is now "Get started" on demos, verify, telemetry, registry and the 31 /go/ pages (build-controls.py template), and "First tutorial" on the static catalog (build-discovery.py).
  • 404: "Run the 10-minute quickstart" is now "Get started with a specification".
  • Homepage: the Build button reads "Get started, software mode", and the scope bullet says the start pages and demos run in software mode.
  • demos: the two links that meant the cMCP tutorial now go to cmcp.agentrust-io.com/quickstart/.
  • llms.txt: the "10-minute tool-call tutorial" entry becomes a Get started entry describing the page.

The About section of /community/ is removed. It called AgenTrust "an open ecosystem for verifiable AI agent governance", described cMCP as governing tool calls, left out the Weight Custody Manifest, and repeated what the homepage chain and /telemetry/ already say. Nothing linked to it except the page's own side rail, whose About item goes with it.

Checked

  • build-header.py --check (12 pages), build-controls.py --check, build-discovery.py --check, check-site.py (43 pages, 728 local links), check-discovery.py, check-dashes.js, marketplace.test.js, check-tdx-verifier.mjs, render-adoption.mjs --check and wcm/redirect.test.js pass.
  • A grep for "10-minute", "Quickstart" link text, "First tutorial", check-quickstart and the About anchor finds nothing left, apart from "explore a ten-minute demo" in the community adoption pathway, which describes the demos.
  • The visible text of the new page passes the house style linter.
  • Headless Chrome screenshots of /quickstart/ at 1400 wide and inside a 400px frame show the six cards in two columns on a wide screen and one column on a phone. A rendered DOM of /community/ has no about section, and its rail lists Top, Ecosystem, Who's involved, Governance, Compliance, Fellowship and Book.

Generated with Claude Code

https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2

/quickstart/ was the cMCP tutorial, titled "cMCP Quickstart: Block a Tool
Call and Verify the Receipt", while the header, footers and 404 page called it
the site's "10-minute quickstart". It is now a short Get started page: six cards
labelled with the chain steps, each linking to that specification's own start
page, and the in-browser TDX check for readers who install nothing.

The cMCP tutorial lives in the cMCP docs, so the quickstart CI job and
tools/check-quickstart.py go, and the links that meant the tutorial point at
cmcp.agentrust-io.com/quickstart/. The menu, footers, 404 page, catalog footer
and llms.txt say Get started.

The About section of /community/ is removed. It described AgenTrust as an
ecosystem for agent governance, omitted WCM, and repeated the homepage chain
and /telemetry/.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2
@imran-siddique
imran-siddique merged commit 8a7999b into main Sep 14, 2026
5 checks passed
@imran-siddique
imran-siddique deleted the feat/get-started branch September 14, 2026 22:04
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