Skip to content

UX: Add onboarding guidance after workspace initialization #467

@frankbria

Description

@frankbria

Problem

When a new workspace opens with no data, the dashboard doesn't explain the intended sequence of actions. After initialization, the user sees stats cards and QuickActions but no guidance on the next step.

Impact

New users don't know whether to start with PRD, create tasks manually, or execute existing tasks, causing confusion and high friction for first-time use.

Recommendation

After workspace initialization, show a welcome card that explains:

  1. Start in PRD page to define requirements
  2. Generate tasks from PRD
  3. Execute tasks with the AI agent
  4. View proof gates to verify quality

Include a 'Get Started →' button linking to /prd. Card dismisses on first navigation.

Acceptance Criteria

  • Welcome card appears after init when no PRD/tasks exist
  • Card explains 4-step pipeline visually
  • CTA links to /prd page
  • Card is dismissible and doesn't reappear
  • Doesn't appear if workspace already has data

Affected Components

web-ui/src/app/page.tsx, web-ui/src/components/workspace/WorkspaceHeader.tsx

Metadata

Metadata

Assignees

Labels

phase-6.3Phase 6.3: UX/UI design improvements for user journey through Think→Build→Prove→Shippriority:highux

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions