Story
As a first-time TalkTerm user,
I want go through the five guided steps — intro, a voice exercise, an ActionCard exercise, a mini-brainstorm, and a wrap-up — and end with a real 3-item artifact I created,
so that I finish onboarding understanding all three interaction modes and leave with something tangible instead of a throwaway demo.
Acceptance Criteria
- Step 1 introduces the avatar and the three interaction modes (voice, ActionCard/click, text).
- Step 2 guides the user through a real voice-input exercise using the existing voice input path.
- Step 3 guides the user through selecting a real ActionCard (UX-DR2).
- Step 4 runs a mini-brainstorm that produces a real 3-item artifact rendered in the OutputPanel (UX-DR4).
- The produced artifact persists after the tutorial ends so the user retains it in the normal app.
- Step 5 has the avatar summarize what the user just learned across the three modes.
Tasks / Subtasks
Dev Notes
- Implement steps as data against the story-2 step interface; do not add new engine control flow here.
- Step 4 is the one step that clearly produces generated content and thus may touch the live pipeline/TTS — bound it to the epic cost cap (a small token ceiling; a 3-item output, not an open-ended brainstorm). Whether steps 2/3 also route through the real pipeline is the open pipeline-boundary question; keep those steps generation-free unless that question is resolved otherwise.
- Reuse ActionCards (UX-DR2), OutputPanel (UX-DR4), and voice/text input (UX-DR9) exactly as a normal session would render them, so the user learns the real UI, not a tutorial-only mock.
- Artifact persistence must use the same mechanism a normal session uses to keep an OutputPanel artifact, so it naturally survives the transition out of the tutorial.
- Keep the brainstorm topic generic here (a safe default); role-specific topic selection is story 4's job and should not be duplicated in the step content.
- Testing: verify each step's completion predicate fires on the corresponding real input/selection event; verify the step-4 artifact has exactly 3 items and remains present after the tutorial session ends.
Project Structure Notes
Adds concrete step definitions plus the brainstorm-to-OutputPanel wiring; renders through existing ActionCard/OutputPanel/input components without forking them. If this PR grows too large to review, the step-4 brainstorm artifact + persistence slice is the natural split point; the four scripted steps stay together as one coherent flow.
References
Likely target surface
tutorial step definitions (five steps)brainstorm-to-OutputPanel artifact wiringartifact persistence into the normal app
Story prepared by the BMAD Scrum Master (Bob) for epic #333. Status: ready-for-dev.
Story
As a first-time TalkTerm user,
I want go through the five guided steps — intro, a voice exercise, an ActionCard exercise, a mini-brainstorm, and a wrap-up — and end with a real 3-item artifact I created,
so that I finish onboarding understanding all three interaction modes and leave with something tangible instead of a throwaway demo.
Acceptance Criteria
Tasks / Subtasks
Dev Notes
Project Structure Notes
Adds concrete step definitions plus the brainstorm-to-OutputPanel wiring; renders through existing ActionCard/OutputPanel/input components without forking them. If this PR grows too large to review, the step-4 brainstorm artifact + persistence slice is the natural split point; the four scripted steps stay together as one coherent flow.
References
Likely target surface
tutorial step definitions (five steps)brainstorm-to-OutputPanel artifact wiringartifact persistence into the normal appStory prepared by the BMAD Scrum Master (Bob) for epic #333. Status: ready-for-dev.