Draft Stonk User Flow Map

Confirmed on 2026-07-02 from $user-flow-map draft-stonk round-one answers and inline coverage confirmation.

Confirmation Record

alignment_status: confirmed

Confirmed artifacts: design/user-flow-draft-stonk.md, design/user-flow-draft-stonk-interview.md, design/flow-tree-draft-stonk.yaml.

The page is current for the completed alignment cycle. Later research or prototype evidence can amend it only by archiving this confirmed page and highlighting the changed evidence or scope.

Scope

This map owns the canonical activation loop: first visit, concept comprehension, first stock pick, compact snake draft against simple bots, equal-dollar standings, and replay/share/invite as the post-success branch.

Explicit non-goals: full league management, production account systems, payments, brokerage handoffs, teacher dashboards, creator-led public contests, formal approvals, support operations, real-money trading, cash prizes, gambling mechanics, and investment advice.

Persona

U.S. finance-curious social retail player, with fantasy-sports-adjacent friend groups and college finance clubs as secondary contexts.

Success

User makes a first pick quickly, completes a short bot draft, understands equal-dollar standings, and chooses replay, share, or invite.

Happy Path

1. LandConcept and trust boundary.
2. StartNo account required.
3. PickSearch by company or ticker.
4. DraftCompact snake draft vs bots.
5. StandingsEqual-dollar comparison.
6. PayoffReplay, share, or invite.

Ordered Branches

The user explicitly chose proof-priority order over pure journey chronology: first-pick speed, equal-dollar standings, concept explanation, then replay/share/invite.

OrderBranch IDStageFirst value momentPrimary review focus
1first-pick-speedOnboardingValid first stock pick.Time-to-first-pick, search, duplicate prevention, pick-not-trade copy.
2equal-dollar-standingsAha momentFair standings understood.Scoring clarity, equal-dollar normalization, data labels.
3concept-explanationDiscovery/evaluationConcept and trust boundary understood.Category language, no-money/no-prize/no-advice clarity.
4replay-share-inviteAdvocacy/retentionUser starts another round or names someone to challenge.Share readability, invite motivation, club context, replay intent.

Surface Inventory

SurfacePurposeChannelsInputsOutputs
Start and conceptMake product legible and safe enough to start.Web UI, mobile webStart, learn-first, invite contextDraft start intent
Stock chooserConvert intent into first pick quickly.Web UI, mobile webSearch, browse, pickUser first pick and validation
Draft boardShow snake draft and bot picks.Web UI, mobile web, local event logUser picks, restart/cancel if allowedPick order and draft events
Draft completionBridge final pick to result.Web UI, mobile webAutomatic continueCompleted draft summary
Standings and resultProve fairness with equal-dollar standings.Web UI, mobile web, local calculationInspect, expand explanationRanked picks and data labels
Replay/share/invitePreserve post-success social payoff.Web UI, mobile web, OS share where availableReplay, share, inviteNew draft or external handoff

Actions And States

Required states across surfaces: empty/new visit, loading, no results, validation blocked, partial draft, bot picking, interrupted draft, scoring error, success, copied/share unavailable, offline/local data unavailable, and data-label warning.

validation_result:
  status: allowed|blocked|error
  reason: duplicate_pick|stock_not_found|data_unavailable|share_unavailable
  next_action: browse|choose_another|retry|copy_fallback|restart

Failure And Recovery

Primary recovery paths are compact concept explanation for confusion, visible trust copy for trading/advice anxiety, browse suggestions for search misses, duplicate-pick blocking, restart/resume for interrupted drafts, clear mock/delayed/local labels for data trust, and copy fallback for unavailable share APIs.

Platform Fit

Recommendation: primary web_app, companion mobile_web_pwa, and prototype shape game_playable. Defer native mobile and event-specific surfaces until replay/share pull is proven. Reject CLI, API, SDK, browser extension, desktop, integration automation, and marketplace paths for this first activation loop.

Next Work

Recommended next skill: $state-model draft-stonk

Next pending branch: first-pick speed, the fast path from first visit to a valid first stock pick.

Agent routing: invoke the state-model skill first to author the flow-anchored domain model; then grow the first-pick speed UX branch with UX variations.