Skip to content

feat(onboarding): collapse the four-wall install funnel to one — agent-carried onboarding#4

Merged
filocosta46 merged 11 commits into
mainfrom
feat/onboarding-funnel
May 23, 2026
Merged

feat(onboarding): collapse the four-wall install funnel to one — agent-carried onboarding#4
filocosta46 merged 11 commits into
mainfrom
feat/onboarding-funnel

Conversation

@filocosta46
Copy link
Copy Markdown
Owner

Fixes DotAIOS priority #1 — the "Terminal wall" that blocks the non-technical web-chat ICP from onboarding. Content/docs-only change set on top of the approved spec + plan (docs/superpowers/specs/2026-05-22-onboarding-funnel-design.md, docs/superpowers/plans/2026-05-22-onboarding-funnel.md). No CLI feature code, no new infrastructure.

What shipped

Surface Change
website/app.jsx + styles.css Broken "Ask Claude Code" CTA → two-step get-started box (open an agent app → paste one line; no agent-download button, per Filippo's call); v0.3 pill → open source; honest sync/server wording; new "What it does" section (sync, web-fetch, sessions); ubiquity copy
INSTALL.md Full rewrite — single canonical agent script; agent installs Node itself (brew / winget / nvm); lean 3-question interview; sync/capture/brief named but not run on first setup
README.md / docs/friend-setup.md Agent path (INSTALL.md) separated from the human-terminal path; canonical Claude URL; stale "no cloud sync" Principles line corrected
installers/windows/ Marked unshipped reference path (KISS-rejected; native installer would require code-signing + per-OS CI infrastructure DotAIOS would have to own, and still need an agent app + Node to be useful)

Evaluation fixes folded into the build

Spec + plan were critically evaluated before build; four accuracy fixes were folded in:

  1. dotaios schedule install is print-only in source — INSTALL.md no longer falsely promises it as an auto-scheduler.
  2. INSTALL.md uses npx dotaios … throughout — npx never installs the CLI globally, so bare dotaios would fail "command not found."
  3. README's stale "no cloud sync" Principles line corrected — sync shipped.
  4. Website "What it does" capture card aligned to npx dotaios capture enable claude-code.

Open decision — resolved

The "easiest-default agent" question (Claude Code vs Claude Desktop / Cowork) was a false dichotomy: claude.com/download serves the Claude desktop app, which hosts Claude Code. The desktop app has shell access (funnel's hard requirement); a pure chat app would break the install step. Filippo's overriding steer: name the agents and suggest Claude Code, but no download link/button on the site — the user picks and downloads on their own.

Verification

  • Tests: 335 pass, 0 fail, 1 skipped (npm test).
  • Render: full Playwright accessibility-snapshot check on local python3 -m http.server build — every section present (hero pill, two-step install box, hero-meta, "What it does", HowItWorks, Marketplace, Footer), no JSX runtime error. Responsive collapse CSS-verified (.steps1fr at @media (max-width: 980px)).
  • Code review: 5-angle review + sweep applied inline to the diff — no correctness defects. Two cosmetic notes only: prompt char abuts the paste text in the hero (no margin on .prompt); .arg CSS class now orphaned. Neither blocks.
  • Vercel preview: https://dotaios-dnjpppjbm-filippos-projects-dc6390a0.vercel.app — READY, target preview, SSO-protected.

Out of scope (deliberate)

  • No CLI feature code (including --agent mode — documented follow-up only).
  • No npm publish, no production deploy, no merge.
  • GitHub-sync feature branch not touched.

🤖 Generated with Claude Code

filocosta46 and others added 10 commits May 22, 2026 16:26
Option 2 of the options memo: the agentic app carries DotAIOS in.
Reframes the four onboarding walls (install app, open terminal, have
Node, run setup) into one — install a single agent app — and routes
the rest through the agent. Covers website refresh, the paste-line
handoff, and INSTALL.md as the canonical agent script. Native
installers rejected on KISS.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Nine tasks across website (app.jsx, styles.css), INSTALL.md, README.md,
friend-setup.md, and the Windows installer note. Content/docs only —
no CLI feature code, preview deploy only. Implements the spec at
docs/superpowers/specs/2026-05-22-onboarding-funnel-design.md.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Agent installs Node itself; lean 3-question interview; optional
extras named but not run on first setup. npx dotaios used throughout
(the CLI is never installed globally). schedule extra reworded —
schedule install is print-only, not an auto-scheduler.
…path

Also fixes the canonical Claude download URL and the stale
'no cloud sync' line in Principles — sync shipped.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
dotaios Ready Ready Preview, Comment May 23, 2026 10:32am

- website/styles.css: add display:inline + white-space:normal to
  .install-step-body p code; without them the chip inherits
  display:block + white-space:pre-wrap from .install code and
  the inline AGENTS.md chip broke step 1's sentence onto its own line.
- INSTALL.md: source ~/.nvm/nvm.sh before running nvm install --lts
  on Linux; the curl|bash installer only edits rc files, so the
  next command failed with "nvm: command not found" in the agent's shell.
- INSTALL.md: clarify the identity.md step replaces both `- Name:`
  and `- Role:` placeholder lines, not just one.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@filocosta46 filocosta46 merged commit c253a9e into main May 23, 2026
6 of 8 checks passed
@filocosta46 filocosta46 deleted the feat/onboarding-funnel branch May 23, 2026 10:34
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