---
stepsCompleted: [1, 2, 3, 4, 5, 6, 7]
---

## Build Summary

**Date:** 2025-12-04
**Status:** Build Complete

### Files Generated

**Main Workflow:**

- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/workflow.md`

**Step Files (12 total):**

- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-01-init.md` - Game setup and mode selection
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-02-q1.md` - Question 1 (Level 1)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-03-q2.md` - Question 2 (Level 2)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-04-q3.md` - Question 3 (Level 3)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-05-q4.md` - Question 4 (Level 4)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-06-q5.md` - Question 5 (Level 5)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-07-q6.md` - Question 6 (Level 6)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-08-q7.md` - Question 7 (Level 7)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-09-q8.md` - Question 8 (Level 8)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-10-q9.md` - Question 9 (Level 9)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-11-q10.md` - Question 10 (Level 10)
- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-12-results.md` - Final results and celebration

**Templates:**

- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/templates/csv-headers.template` - CSV column headers

### Key Features Implemented

1. **Dual Game Modes:**
   - Mode 1: Sudden Death (game over on first wrong answer)
   - Mode 2: Marathon (complete all 10 questions)

2. **CSV History Tracking:**
   - 44 columns including DateTime, Category, GameMode, all questions/answers, FinalScore
   - Automatic CSV creation with headers
   - Real-time updates after each question

3. **Gameshow Persona:**
   - Energetic, dramatic host presentation
   - Progressive difficulty from Level 1-10
   - Immediate feedback and celebration

4. **Flow Control:**
   - Automatic CSV routing based on game mode
   - Play again or quit options at completion

### Next Steps for Testing

1. Run the workflow: `/bmad:bmb:workflows:quiz-master`
2. Test both game modes
3. Verify CSV file creation and updates
4. Check question progression and difficulty
5. Validate final score calculation

## Plan Review Summary

- **Plan reviewed by:** User
- **Date:** 2025-12-04
- **Status:** Approved without modifications
- **Ready for design phase:** Yes
- **Output Documents:** CSV history file (BMad-quiz-results.csv)

# Workflow Creation Plan: quiz-master

## Initial Project Context

- **Module:** stand-alone
- **Target Location:** /Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master
- **Created:** 2025-12-04

## Detailed Requirements

### 1. Workflow Purpose and Scope

- **Primary Goal:** Entertainment-based interactive trivia quiz
- **Structure:** Always exactly 10 questions (1 per difficulty level 1-10)
- **Format:** Multiple choice with 4 options (A, B, C, D)
- **Progression:** Linear progression through all 10 levels regardless of correct/incorrect answers
- **Scoring:** Track correct answers for final score

### 2. Workflow Type Classification

- **Type:** Interactive Workflow with Linear structure
- **Interaction Style:** High interactivity with user input for each question
- **Flow:** Step 1 (Init) → Step 2 (Quiz Questions) → Step 3 (Results) → Step 4 (History Save)

### 3. Workflow Flow and Step Structure

**Step 1 - Game Initialization:**

- Read user_name from config.yaml
- Present suggested categories OR accept freeform category input
- Create CSV file if not exists with proper headers
- Start new row for current game session

**Step 2 - Quiz Game Loop:**

- Loop through 10 questions (levels 1-10)
- Each question has 4 multiple-choice options
- User enters A, B, C, or D
- Provide immediate feedback on correctness
- Continue to next level regardless of answer

**Step 3 - Results Display:**

- Show final score (e.g., "You got 7 out of 10!")
- Provide entertaining commentary based on performance

**Step 4 - History Management:**

- Append complete game data to CSV
- Columns: DateTime, Category, Q1-Question, Q1-Choices, Q1-UserAnswer, Q1-Correct, Q2-Question, ... Q10-Correct, FinalScore

### 4. User Interaction Style

- **Persona:** Over-the-top gameshow host (enthusiastic, dramatic, celebratory)
- **Instruction Style:** Intent-based with gameshow flair
- **Language:** Energetic, encouraging, theatrical
- **Feedback:** Immediate, celebratory for correct, encouraging for incorrect

### 5. Input Requirements

- **From config:** user_name (BMad)
- **From user:** Category selection (suggested list or freeform)
- **From user:** 10 answers (A/B/C/D)

### 6. Output Specifications

- **Primary:** Interactive quiz experience with gameshow atmosphere
- **Secondary:** CSV history file named: BMad-quiz-results.csv
- **CSV Structure:**
  - Row per game session
  - Headers: DateTime, Category, Q1-Question, Q1-Choices, Q1-UserAnswer, Q1-Correct, ..., Q10-Correct, FinalScore

### 7. Success Criteria

- User completes all 10 questions
- Gameshow atmosphere maintained throughout
- CSV file properly created/updated
- User receives final score with entertaining feedback
- All question data and answers recorded accurately

### 8. Special Considerations

- Always assume fresh chat/new game
- CSV file creation in Step 1 if missing
- Freeform categories allowed (any topic)
- No need to display previous history during game
- Focus on entertainment over assessment
- After user enters A/B/C/D, automatically continue to next question (no "Continue" prompts)
- Streamlined experience without advanced elicitation or party mode tools

## Tools Configuration

### Core BMAD Tools

- **Party-Mode**: Excluded - Want streamlined quiz flow without interruptions
- **Advanced Elicitation**: Excluded - Quiz format is straightforward without need for complex analysis
- **Brainstorming**: Excluded - Categories can be suggested directly or entered freeform

### LLM Features

- **Web-Browsing**: Excluded - Quiz questions can be generated from existing knowledge
- **File I/O**: Included - Essential for CSV history file management (reading/writing quiz results)
- **Sub-Agents**: Excluded - Single gameshow host persona is sufficient
- **Sub-Processes**: Excluded - Linear quiz flow doesn't require parallel processing

### Memory Systems

- **Sidecar File**: Excluded - Each quiz session is independent (always assume fresh chat)

### External Integrations

- None required for this workflow

### Installation Requirements

- None - All required tools (File I/O) are core features with no additional setup needed

## Workflow Design

### Step Structure

**Total Steps: 12**

1. Step 01 - Init: Mode selection, category choice, CSV setup
2. Steps 02-11: Individual questions (1-10) with CSV updates
3. Step 12 - Results: Final score display and celebration

### Game Modes

- **Mode 1 - Sudden Death**: Game over on first wrong answer
- **Mode 2 - Marathon**: Continue through all 10 questions

### CSV Structure (44 columns)

Headers: DateTime,Category,GameMode,Q1-Question,Q1-Choices,Q1-UserAnswer,Q1-Correct,...,Q10-Correct,FinalScore

### Flow Logic

- Step 01: Create row with DateTime, Category, GameMode
- Steps 02-11: Update CSV with question data
  - Mode 1: IF incorrect → jump to Step 12
  - Mode 2: Always continue
- Step 12: Update FinalScore, display results

### Gameshow Persona

- Energetic, dramatic host
- Celebratory feedback for correct answers
- Encouraging messages for incorrect

### File Structure

```
quiz-master/
├── workflow.md
├── steps/
│   ├── step-01-init.md
│   ├── step-02-q1.md
│   ├── ...
│   └── step-12-results.md
└── templates/
    └── csv-headers.template
```

## Output Format Design

**Format Type**: Strict Template

**Output Requirements**:

- Document type: CSV data file
- File format: CSV (UTF-8 encoding)
- Frequency: Append one row per quiz session

**Structure Specifications**:

- Exact 43 columns with specific headers
- Headers: DateTime,Category,Q1-Question,Q1-Choices,Q1-UserAnswer,Q1-Correct,...,Q10-Correct,FinalScore
- Data formats:
  - DateTime: ISO 8601 (YYYY-MM-DDTHH:MM:SS)
  - Category: Text
  - QX-Question: Text
  - QX-Choices: (A)Opt1|(B)Opt2|(C)Opt3|(D)Opt4
  - QX-UserAnswer: A/B/C/D
  - QX-Correct: TRUE/FALSE
  - FinalScore: Number (0-10)

**Template Information**:

- Template source: Created based on requirements
- Template file: CSV with fixed column structure
- Placeholders: None - strict format required

**Special Considerations**:

- CSV commas within text must be quoted
- Newlines in questions replaced with spaces
- Headers created only if file doesn't exist
- Append mode for all subsequent quiz sessions