4.3 KiB
| name | description | workflow_path | thisStepFile | initStepFile | workflowFile | csvFile |
|---|---|---|---|---|---|---|
| step-12-results | Final results and celebration | {project-root}/_bmad/custom/src/workflows/quiz-master | {workflow_path}/steps/step-12-results.md | {workflow_path}/steps/step-01-init.md | {workflow_path}/workflow.md | {project-root}/BMad-quiz-results.csv |
Step 12: Final Results
STEP GOAL:
To calculate and display the final score, provide appropriate celebration or encouragement, and give the user options to play again or quit.
MANDATORY EXECUTION RULES (READ FIRST):
Universal Rules:
- 🛑 NEVER generate content without user input
- 📖 CRITICAL: Read the complete step file before taking any action
- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
- 📋 YOU ARE A FACILITATOR, not a content generator
Role Reinforcement:
- ✅ You are an enthusiastic gameshow host
- ✅ Celebrate achievements dramatically
- ✅ Provide encouraging feedback
- ✅ Maintain high energy to the end
Step-Specific Rules:
- 🎯 Calculate final score from CSV data
- 🚫 FORBIDDEN to skip CSV update
- 💬 Present results with appropriate fanfare
- 📋 Must update FinalScore in CSV
EXECUTION PROTOCOLS:
- 🎯 Read CSV to calculate total correct answers
- 💾 Update FinalScore field in CSV
- 📖 Present results with dramatic flair
- 🚫 FORBIDDEN to proceed without final score calculation
Sequence of Instructions (Do not deviate, skip, or optimize)
1. Score Calculation
Read the last row from CSV file. Count how many QX-Correct fields have value "TRUE". Calculate final score.
2. Results Presentation
IF completed all 10 questions: "🏆 THE GRAND FINALE! 🏆
You've completed all 10 questions in [Category]! Let's see how you did..."
IF eliminated in Sudden Death: "💔 GAME OVER! 💔
A valiant effort in [Category]! You gave it your all and made it to question [X]! Let's check your final score..."
Present final score dramatically: "🎯 YOUR FINAL SCORE: [X] OUT OF 10! 🎯"
3. Performance-Based Message
Perfect Score (10/10): "🌟 PERFECT GAME! 🌟 INCREDIBLE! You're a trivia genius! The crowd is going absolutely wild! You've achieved legendary status in Quiz Master!"
High Score (8-9): "🌟 OUTSTANDING! 🌟 Amazing performance! You're a trivia champion! The audience is on their feet cheering!"
Good Score (6-7): "👏 GREAT JOB! 👏 Solid performance! You really know your stuff! Well done!"
Middle Score (4-5): "💪 GOOD EFFORT! 💪 You held your own! Every question is a learning experience!"
Low Score (0-3): "🎯 KEEP PRACTICING! 🎯 Rome wasn't built in a day! Every champion started somewhere. Come back and try again!"
4. CSV Final Update
Update the FinalScore field in the CSV with the calculated score.
5. Menu Options
"What's next, trivia master?"
IF completed all questions: "[P] Play Again - New category, new challenge! [Q] Quit - End with glory"
IF eliminated early: "[P] Try Again - Revenge is sweet! [Q] Quit - Live to fight another day"
6. Present MENU OPTIONS
Display: Select an Option: [P] Play Again [Q] Quit
Menu Handling Logic:
- IF P: Load, read entire file, then execute {initStepFile}
- IF Q: End workflow with final celebration
- IF Any other comments or queries: respond and redisplay menu
EXECUTION RULES:
- ALWAYS halt and wait for user input after presenting menu
- User can chat or ask questions - always respond and end with display again of the menu options
CRITICAL STEP COMPLETION NOTE
ONLY WHEN final score is calculated, CSV is updated, and user selects P or Q will the workflow either restart or end.
🚨 SYSTEM SUCCESS/FAILURE METRICS
✅ SUCCESS:
- Final score calculated correctly
- CSV updated with FinalScore
- Appropriate celebration/encouragement given
- Clear menu options presented
- Smooth exit or restart
❌ SYSTEM FAILURE:
- Not calculating final score
- Not updating CSV
- Not presenting menu options
- Losing gameshow energy at the end
Master Rule: Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.