Drop the Discover onboarding step: the what-is-kody guide owns discovery, linked from the homepage hero

[kentcdodds]

Summary

The Discover step made onboarding four steps of work before any setup began, and its content duplicated what the what-is-kody guide already serves. This PR removes the step and gives the homepage the either/or instead.

• Onboarding wizard is three steps: Connect your agent · See it work · Install a starter package. Step numbering, completion checks, auto-advance (connect → step 2, first win → step 3), hash deep-links, and wizard navigation bounds all renumbered; the discovery panel, its prompt state, and now-unused styles removed. The header gains a quiet "New here? Read what Kody can do first." link for people who land directly.
• Homepage hero replaces the old #discovery deep-link hint with the either/or: "Read what Kody can do" links to /guides/what-is-kody, and a small "Copy the discovery prompt" button (fed by the existing onboarding payload's discoveryPrompt, which the home loader already fetches) lets visitors paste one prompt into their agent instead — still no account needed.
• The guide already carries the full discovery flow (its "Try it" prompt stays in sync with buildDiscoveryPrompt via the existing docs-sync test), so no server or docs changes were needed — this is a client-only diff.

Testing

• npm run typecheck, lint, and 346 client+app node tests green; full pre-push suite (unit + workers + e2e) green on push.
• Recorded browser walkthrough: hero hint with working copy state → guide page with the Try it prompt → three-step wizard with the header guide link, stepping through all panels.

System recap — composes existing primitives (low risk)

Mode: recap · Base: main @ 84e9632d · Head: e148a779

Classification: composes — client-only changes inside app-ui: removes the Discover wizard panel and repoints the homepage hero at the existing what-is-kody guide and the payload's existing discoveryPrompt. No routes, storage, capabilities, or server code change.

Primitives touched

Primitive	Group	Impact
app-ui	surfaces	composes — 3-step wizard; hero links /guides/what-is-kody + copies discoveryPrompt

  

Summary by CodeRabbit

• New Features

  • Added a copy button for onboarding prompts on the home page.
  • Added links to the onboarding guide from the home and onboarding screens.
  • Onboarding now presents a streamlined three-step setup flow.

• Improvements

  • Simplified onboarding navigation, progress indicators, and completion states.
  • Removed the previous discovery step and related messaging.
  • Home-page guidance now adapts based on whether a discovery prompt is available.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: bae5435f-5fbb-4bec-b126-f06ee0663062

📥 Commits

Reviewing files that changed from the base of the PR and between e148a77 and af567cb.

📒 Files selected for processing (1)

• packages/worker/client/routes/onboarding.tsx

🚧 Files skipped from review as they are similar to previous changes (1)

• packages/worker/client/routes/onboarding.tsx

---

📝 Walkthrough

Walkthrough

The onboarding wizard now has three steps and no separate discovery step. The home route presents the optional discovery prompt with a copy button and links to the guide.

Changes

Onboarding discovery flow

Layer / File(s)	Summary
Three-step onboarding wizard packages/worker/client/routes/onboarding.tsx	The wizard removes the Discover step, renumbers the remaining panels, updates progress and navigation, removes discovery prompt state, and adds a guide link.
Home prompt presentation packages/worker/client/routes/home.tsx	The home route reads OnboardingPayload.discoveryPrompt. When a prompt exists, it displays guide text and a CopyTextButton.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• kentcdodds/kody#1184: Provides the related discoveryPrompt onboarding data.
• kentcdodds/kody#1186: Introduces the onboarding wizard flow revised by this change.
• kentcdodds/kody#1266: Also changes the onboarding flow and discovery experience.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: removing the Discover onboarding step and linking discovery to the homepage guide.
Description check	✅ Passed	The description includes a detailed summary and testing evidence; the optional System changes section is present, but the required Intent section is missing.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/discovery-to-guide-d7c2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

🔎 Preview deployed: https://kody-pr-1279.kody-a99.workers.dev

Worker: kody-pr-1279
D1: kody-pr-1279-db
KV: kody-pr-1279-oauth-kv

Mocks:

• cloudflare: https://kody-pr-1279-mock-cloudflare.kody-a99.workers.dev/__mocks (kody-pr-1279-mock-cloudflare)

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/worker/client/routes/onboarding.tsx`:
- Around line 63-66: Update wizardStepsCss to use a three-column desktop grid
via repeat(3, minmax(0, 1fr)), matching the three entries in onboardingSteps and
eliminating the unused column.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 74741521-b4d5-44d4-b59d-401b0a3c1928

📥 Commits

Reviewing files that changed from the base of the PR and between fa91d2c and e148a77.

📒 Files selected for processing (2)

• packages/worker/client/routes/home.tsx
• packages/worker/client/routes/onboarding.tsx