Skip to content

[PROTOTYPE · DO NOT MERGE] Reimagined project onboarding flow#1227

Closed
simple-agent-manager[bot] wants to merge 4 commits into
mainfrom
sam/lets-imagine-better-project-01kteg
Closed

[PROTOTYPE · DO NOT MERGE] Reimagined project onboarding flow#1227
simple-agent-manager[bot] wants to merge 4 commits into
mainfrom
sam/lets-imagine-better-project-01kteg

Conversation

@simple-agent-manager

@simple-agent-manager simple-agent-manager Bot commented Jun 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary (DRAFT — prototype, do NOT merge)

Throwaway design exploration that reimagines project creation as project onboarding. Route: /prototype/project-onboarding (public, unauthed, mock data only). Per .claude/rules/37-prototype-development.md, this must be deleted before any merge to main — it is not a shippable deliverable.

The 3-step flow

  1. Connect your code — search/select a GitHub repo (the only working source today), then fill the minimal required info: project name (pre-filled from the repo) and working branch. Description dropped.
  2. Set up — a hand-held, fully skippable walkthrough that actually creates configuration instead of describing it:
    • Conversational profile — pick agent + model; wired up as a lightweight workspace in conversation mode.
    • Task profile — pick agent + model, then describe how it should finish a task (branch/commit/PR/push). Amber callout warns that workspaces are ephemeral — unpushed work is gone for good.
    • Trigger (optional) — a cron-only schedule that runs the task profile. GitHub event triggers excluded (untested).
  3. Kick off — an isolated, centered project-chat composer (with voice). Task vs. conversation toggle; either way you land inside the project, in motion.

Latest revision (review feedback)

  • Readable Continue button — replaced the hand-rolled black-on-green button with the shared <Button variant="primary"> from @simple-agent-manager/ui (correct text-fg-on-accent contrast).
  • Branch-protection copy — agents work directly on the chosen branch; branch protection is the user's job via GitHub, not SAM's.
  • Setup is no longer static — the old feature-education screen is now an interactive walkthrough (conversational + task profiles + optional cron trigger). Skills dropped (untested).

Verification

  • tsc --noEmit clean for the prototype file.
  • ESLint: 0 errors (5 non-null-assertion warnings on guarded/non-empty-literal indexing; CI does not enforce --max-warnings 0).
  • Playwright visual audit across the full flow (Connect → Setup ×3 → Kickoff) at mobile 375×667 and desktop 1280×800: no horizontal overflow at any step, primary buttons readable.

🤖 Generated with Claude Code

raphaeltm and others added 4 commits June 6, 2026 13:18
@raphaeltm @claude
Add project-onboarding prototype (reimagined creation flow)
fe4a319 
Explores reimagining /projects/new as a short guided onboarding: connect
code, choose a first intent, and land in motion instead of an empty
project. Self-contained unauthed prototype at /prototype/project-onboarding
with stress-test mock data; visual-audited on mobile and desktop.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@raphaeltm @claude
Rework onboarding prototype: GitHub-only, feature education, kickoff …
2a8dd05 
…composer

- Remove the non-functional "start fresh / SAM Git" path; GitHub is the only source
- Collect minimal required info up front: repo + project name + working branch
  (branch is a first-class required field; description dropped)
- Add a skippable Discover step that teaches Agent Profiles, Triggers, and Skills
  with "why it matters" value-prop framing (task system intentionally not surfaced)
- Replace intent-based routing with a single isolated kickoff composer (task vs.
  conversation mode + voice input) that always lands the user inside the project
- Stress-test mock data with long branch names and a Unicode branch

Prototype only — route /prototype/project-onboarding, mock data, delete before merge.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@raphaeltm @claude
prototype: guided setup walkthrough, readable Continue button, branch…
299bb2a 
…-protection copy

Address review feedback on the project-onboarding prototype:
- Replace hand-rolled black-on-green Continue button with the shared
  <Button variant="primary"> (correct text-fg-on-accent contrast).
- Reframe the working-branch hint: agents work directly on the chosen
  branch; branch protection is the user's responsibility via GitHub.
- Replace the static "Discover" feature-education screen with an
  interactive, skippable setup walkthrough that actually creates a
  conversational profile, a task profile (with PR/branch guidance and
  an ephemeral-workspace warning), and an optional cron-only trigger.
  Skills are dropped from onboarding (untested).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@raphaeltm @claude
task: use real agent catalog, drop quality claims, cron-only triggers…
3af916e 
… in onboarding prototype

- Show the user's enabled agents only (Claude Code, OpenAI Codex, Gemini CLI)
  with a "N more in profile settings" link to the rest of the real 6-agent catalog
- Remove all marketing/quality blurbs; agent + model labels are factual names
  from the real shared catalog
- Remove the GitHub-event-trigger note entirely; show cron schedules only

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@sonarqubecloud

sonarqubecloud Bot commented Jun 6, 2026

Copy link
Copy Markdown

Quality Gate Failed Quality Gate failed

Failed conditions
3.3% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud

@simple-agent-manager

simple-agent-manager Bot commented Jun 7, 2026

Copy link
Copy Markdown
Contributor Author

Closing: explicitly marked [PROTOTYPE · DO NOT MERGE]. Superseded by the productionized onboarding wizard in #1233.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@raphaeltm