Rewrite get-started so a human can install - #193
Merged
Conversation
…uter The live opener treated the calling agent as the default reader and led with claude mcp add. Humans install Desktop or pip first. Tutorial is optional. Validator strings stay on the page, not in the lead.
openadapt-web is private, so raw.githubusercontent.com 404s in Actions. Match desktop #154: Contents API + ADMIN_TOKEN, fail closed on HTTP errors.
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
| url = request.full_url | ||
| requested.append(url) | ||
| authed.append(request.has_header("Authorization")) | ||
| if "raw.githubusercontent.com" in url: |
| assert vendor.main() == 0 | ||
| assert any("/contents/styles/tokens.json" in url for url in requested) | ||
| assert any("/contents/styles/tokens.css" in url for url in requested) | ||
| assert not any("raw.githubusercontent.com" in url for url in requested) |
Member
Author
|
Merged by an agent session, not the founder. |
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
2 participants
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.
The live get-started page opened with "The default reader is the calling agent" and led with
claude mcp add. That's the wrong door. The person who lands here wants an agent to do a job on this computer. They install first.What this PR does
docs/get-started/index.mdis a rewrite, not a polish pass. Install is the required first success. Desktop and pip are equal. If they came from a job page, they go back to/j/{id}. The bundled tutorial (openadapt quickstart, optionally--break-it) is optional and doesn't name MockMed. MCP for Claude Code and Cursor sits later. Qualification, Seal, compose, and oracle tiers are gone from this page.Aliases no longer dump the tutorial-first lecture:
docs/start/index.mddocs/getting-started/index.mddocs/getting-started/quickstart.mddocs/getting-started/installation.mddocs/llms.txtno longer cites MCP as the first get-started step. The docs home primary button and matching card now say "Install OpenAdapt" instead of "Call it from an agent".Validator strings still required on get-started, and still present, just not in the lead:
pip installopenadapt quickstart--break-ittutorialfirst-workflow.mdclaude mcp add openadaptNever summarize halt as success--break-itstays forbidden infirst-workflow.md. This PR doesn't add it there.Left alone
first-workflow.md,what-you-get.md, Seal, qualify, compose, and the commercial execute pages. The homepage lede and calling-agent contract box still have to say "calling agent". openadapt-web 462 is a separate change.CI
The
Vendored design tokens match openadapt-webcheck returned HTTP 404 onhttps://raw.githubusercontent.com/OpenAdaptAI/openadapt-web/main/styles/tokens.jsonbecause that repo is private. Same hole as desktop 154.--checknow reads those files from the GitHub Contents API:GET /repos/OpenAdaptAI/openadapt-web/contents/styles/<file>?ref=mainwithAccept: application/vnd.github.raw. The job setsGITHUB_TOKENfromsecrets.ADMIN_TOKEN, falling back togithub.token. github.token can't read a private sibling repo. A 404 still fails the job. It does not count as a match.Opened by an agent session, not the founder.