270 lines
9.1 KiB
Markdown
270 lines
9.1 KiB
Markdown
---
|
|
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
|