Skip to content

docs: clarify onboarding and add prompt-first guides - #28

Merged
kmox83 merged 12 commits into
mainfrom
docs/pages-onboarding
Oct 14, 2026
Merged

kmox83 merged 12 commits into
mainfrom
docs/pages-onboarding

Conversation

@kmox83

@kmox83 kmox83 commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

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

  • Compact home and Start here definitions for plugin, skill, host and repository; clear single-repository and multi-repository paths with accurate minimal setup.
  • Prompt-first guides for existing, ordinary-folder, mixed, new and resumed workspaces; host selection and progressive, JavaScript-free access.
  • Persistent navigation, breadcrumbs and responsive layouts; reference for assembly, schemas, skill roots and qualification; aligned README/USAGE.
  • Visual explanation of federation versus portable workspaces and fourteen FAQ answers in four groups. Existing scenario URLs and important anchors are preserved.

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.
  • Both native gates pass on final head fa5eaf5a5e2af5ecdc8f34d97e863e76b755d9b3.
  • Jekyll 3.10 safe build: exit 0; 25 rendered pages and 1,073 local link/asset/anchor checks, including all baseline anchors.
  • Chromium: 75 page/viewport checks at 1440, 390 and 320px, plus 25 navigation interactions, 23 existing journeys and 47 focused FAQ/diagram checks. No document overflow or captured console/page errors.
  • Actual 200% browser zoom: nine checks; keyboard/skip/menu/focus and JavaScript-free paths pass.

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.md with actual PR #28 and verified work HEAD 06be1340805591a52f3b8bb48c263eb581e2371f. 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

  • This run: sole writer submitted accepted documentation and prepared plan 0080 completion on docs/pages-onboarding; final-head verify and hostless evals both exit 0.
  • Overall: operator-accepted and locally verified; ready non-draft PR, unshipped and unpublished. Required verify CI is successful on final head fa5eaf5a5e2af5ecdc8f34d97e863e76b755d9b3; Cursor review checks have started on that same head.
  • Yet to do: remaining Cursor review and separately authorised merge/publication. Preview and branch retained; controller owns agent/worktree/tab cleanup. Native qualification remains outside this item.

kmox83 added 12 commits October 14, 2026 10:59
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.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Cursor Bugbot and Cursor Security Agent both completed successfully with no findings that need human review.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

@kmox83
kmox83 merged commit e8d487a into main Oct 14, 2026
4 checks passed
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