[kentcdodds]

Why

People invited to try Kody often can't tell whether they have a use case — they don't know what Kody is capable of, and the existing onboarding setup prompt assumes they already want to connect an integration. This adds a discovery path that works before any account or MCP setup, from any tool-calling agent (ChatGPT, Claude Desktop, a phone), as long as it can fetch a URL or search the web. The prompt stays simple; the linked doc carries the detail.

What

• docs/use/what-can-kody-do.md — outcome-oriented capability tour written for both humans and agents: what Kody is, the building blocks (with links into existing usage docs), concrete example use cases, and a "running a discovery conversation" section that tells an agent how to interview the person and propose ranked opportunities. Everything resolves on GitHub with no account.
• buildDiscoveryPrompt() in onboarding-data.ts — a short copyable prompt identifying Kody by the deployment origin (https://heykody.dev in production, via getAppBaseUrl), pointing the agent at that doc, and asking it to interview the user and propose 3–5 concrete automations ranked by payoff versus setup effort.
• /onboarding — new "Not sure what you'd use Kody for?" card (before step 1) with the prompt and a copy button. Served to logged-out visitors and never gated by email verification, since discovery needs no credentials.
• Homepage hero — a muted "Ask your agent with the discovery prompt" link to /onboarding#discovery.
• docs/use/index.md — links the new page, and adds the previously missing email-primitives.md entry.

Testing

• npm run validate — all seven checks green (format, lint, typecheck, unit, Playwright E2E, MCP E2E, primitives).
• Unit tests cover the new discoveryPrompt payload field in public, verified, and unverified-gated loader states, plus the exact production-origin prompt string.
• Manual GUI walkthrough on the local dev server (logged out): homepage hint link → onboarding discovery card → copy button "Copied" feedback → rest of onboarding intact.

System recap — extends existing primitives (medium risk)

Mode: recap · Base: main · Head: cursor/discovery-prompt-0f5b @ bd818aa7

Classification: extends — the onboarding loader payload gains a discoveryPrompt field rendered by the onboarding and home routes; no new primitives.

Primitives touched

Primitive	Group	Impact
app-ui	surfaces	extends — onboarding/home routes render the discovery prompt
app-sessions	auth	composes — onboarding data loader adds an ungated static field

System map

The discovery prompt flows from the onboarding data loader through the loader payload into the onboarding and home routes, and points readers at a new GitHub usage doc.

Legend: green = composes (wiring only) · amber = extended by this PR · red = new primitive · gray = context (unchanged, included only when an edge crosses it).

flowchart LR
	appSessions["app-sessions<br/>Browser sessions"]:::touched
	appUi["app-ui<br/>Browser app (Remix 3)"]:::extended
	docsUse["docs/use<br/>GitHub usage docs"]:::extended
	appSessions -->|"discoveryPrompt in onboarding payload"| appUi
	appUi -->|"prompt links what-can-kody-do.md"| docsUse
	classDef touched fill:#1a7f37,color:#fff
	classDef extended fill:#9a6700,color:#fff
	classDef added fill:#cf222e,color:#fff
	classDef untouched fill:#57606a,color:#fff

Loading

  

Summary by CodeRabbit

• New Features

  • Added a new “What can Kody do?” guide with capabilities, use cases, and a ready-to-use discovery prompt.
  • Added a discovery hint to the home page.
  • Added a discovery section to onboarding, including a prompt that can be copied.

• Documentation

  • Expanded the Guides table of contents with links to the new discovery guide and email primitives guide.

[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: 4c58b433-7675-4f5d-8627-4e68defc89be

📥 Commits

Reviewing files that changed from the base of the PR and between b5ad13a and bd818aa.

📒 Files selected for processing (9)

• docs/use/index.md
• docs/use/what-can-kody-do.md
• packages/worker/client/routes/home.tsx
• packages/worker/client/routes/onboarding.tsx
• packages/worker/src/app/handlers/onboarding.node.test.ts
• packages/worker/src/app/loader-data.ts
• packages/worker/src/app/onboarding-data.node.test.ts
• packages/worker/src/app/onboarding-data.ts
• packages/worker/src/app/ssr-render.node.test.ts

---

📝 Walkthrough

Walkthrough

Changes

The PR adds a generated discovery prompt to onboarding payloads, displays it with copy support in the onboarding UI, links to discovery from the home page, and adds documentation for Kody capabilities and email primitives.

Discovery onboarding

Layer / File(s)	Summary
Discovery prompt pipeline packages/worker/src/app/onboarding-data.ts, packages/worker/src/app/loader-data.ts, packages/worker/src/app/*test.ts	Generates discoveryPrompt, includes it across onboarding data flows, and updates API, loader, and SSR assertions.
Onboarding discovery presentation packages/worker/client/routes/onboarding.tsx, packages/worker/client/routes/home.tsx	Renders the prompt with a copy button and adds a home-page link to the onboarding discovery section.
Discovery documentation docs/use/index.md, docs/use/what-can-kody-do.md	Adds the capability discovery guide and links it, along with the email primitives guide, from the documentation index.

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

Sequence Diagram(s)

sequenceDiagram
  participant Visitor
  participant HomeRoute
  participant OnboardingRoute
  participant OnboardingData
  Visitor->>HomeRoute: select discovery link
  HomeRoute->>OnboardingRoute: navigate to onboarding#discovery
  OnboardingRoute->>OnboardingData: load onboarding payload
  OnboardingData-->>OnboardingRoute: return discoveryPrompt
  OnboardingRoute-->>Visitor: render prompt and copy action

Loading

Possibly related PRs

• kentcdodds/kody#705: Both changes expand the onboarding prompt-copying UI using CopyTextButton.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: adding a pre-setup discovery prompt for prospective users.
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-prompt-0f5b

---

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-802.kody-a99.workers.dev

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

Mocks:

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