Repository navigation
docs: clarify onboarding and add prompt-first guides - #28
Merged
Merged
Conversation
Trace to ADRs 0051, 0059, 0060 and 0061. Operator accepted the bounded proposal; local preview and signed commits only.
Implement the accepted Pages redesign under plan 0080 and ADRs 0051, 0059, 0060 and 0061. Retain Jekyll, existing routes and fragments; add host-aware onboarding, prompt-first guides and reference navigation. Preserve unresolved Grok installation evidence and native qualification limits. No product, gate, schema or version changes.
Apply operator review to plan 0080: reuse the released warm palette, serif headings, amber buttons, logo and artwork while retaining the new content, navigation and responsive protections.
Illustrate federation and independent portable workspaces, including coexistence and native ownership. Add fourteen grouped answers with native keyboard disclosures, retaining the released visual identity and all existing routes and anchors. Trace existing decisions 0019, 0024, 0025 and 0051 through plan 0080.
Rationale: Operator accepted the documentation and authorised ready PR submission. Prepare only item 0080 completion with the actual PR URL and verified work HEAD. Keep broader owning decisions and INDEX unchanged because their native qualification remains outside this documentation scope; completion takes effect only on checked merge.
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.


New adopters can start with one repository or a portable workspace, choose their actual coding host, and follow a prompt through its expected result, checks and next step. The site stays static Jekyll/Pages and preserves the original warm paper, serif headings, amber actions and brand artwork.
Changes
Validation
Operator accepted the rendered documentation at
0ef8aa296bbe11442d42a2b526edc60d0f310917. Source is unchanged in this PR-submission phase.node scripts/verify.mjs: exit 0 — version 0.10.0, 14 skills, 63 ADRs, 70 shipped plan items (including the completion prepared on this unmerged branch).node evals/run.mjs: exit 0 — 13 passed, 0 failed, 0 skipped; hostless.fa5eaf5a5e2af5ecdc8f34d97e863e76b755d9b3.Grok's bare-name install selector remains explicitly unverified. Deterministic checks and local browser review do not establish native-host or platform acceptance; seven host-guide smokes and full native qualification remain pending. Physical devices, other browser engines and screen readers were not tested. No product skill/runtime/schema/version/gate changes or expanded support claims. No release, deployment or Clarity work.
Required CI: Verify run 38576347576 passed on the final head. Cursor Bugbot, Security Reviewer and PR Router/Approver were triggered on that same head; their live check results remain authoritative.
Prepared completion
Plan 0080 is moved to
plan/done/2026-10-14-pages-onboarding.mdwith actual PR #28 and verified work HEAD06be1340805591a52f3b8bb48c263eb581e2371f. Completion takes effect only on checked merge. Broader owning ADRs and INDEX are unchanged because their remaining native qualification is outside this documentation scope.Status at a glance
docs/pages-onboarding; final-head verify and hostless evals both exit 0.verifyCI is successful on final headfa5eaf5a5e2af5ecdc8f34d97e863e76b755d9b3; Cursor review checks have started on that same head.