docs(guides): add AI tooling context page - #30
Conversation
✅ Deploy Preview for ordo-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
1b71c17 to
d4a696b
Compare
|
Follow-up on the version-pinning advice I added for the second review comment — it overpromised, so I have corrected it here and fixed the underlying cause upstream. The problem: the bundle is versioned, but the schema/CLI/API pages it links are published for the latest release only (there are no per-release docs URLs — I checked, On this page:
Upstream (ordo#170): the bundle now stamps the release it was generated for, states the latest-reference caveat itself, and its broken links are repaired — the same Pushed as a fixup on the page commit; build is clean. |
|
Added a Set it up in one step section at the top: a copy-able prompt that hands the assistant this page and lets it do the install. The prompt tells it to read the page, pick the role ( Starlight's code blocks carry a copy button by default, so no new component was needed. Verified in the built output rather than assumed: the block renders with a copy button, its payload is the full prompt, and the line breaks survive the copy (11 line separators in the encoded payload), so pasting gives a properly formatted multi-line prompt rather than one run-on line. Pushed as a fixup; build clean. |
Document how to fetch and use the AI context bundle Ordo ships: the branded curl one-liner, the two role directories (module-author, operator), and how to drop AGENTS.md/CLAUDE.md into a project. Notes that the bundle links the live schema and CLI reference rather than copying them.
a60c7cd to
2dbaf9c
Compare
New Guides page: AI tooling context — how to fetch and use the context bundle Ordo ships for AI coding assistants.
curl -fsSL https://getordo.dev/ai-context.tar.gz | tar xzmodule-author,operator) and how to dropAGENTS.md/CLAUDE.mdinto a projectBuilds clean locally (
/guides/ai-tooling-context/).The page's
getordo.dev/ai-context.tar.gzone-liner only works after the delivery chain lands:dl.getordo.dev/ai-context.tar.gzexistsgetordo.dev/ai-context.tar.gzresolvesMerge this after both. Verify: