bmm-opencode 1.4.3 → 1.6.0

package/_bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-01-init.md

@@ -0,0 +1,235 @@
+---
+name: 'step-01-init'
+description: 'Initialize TEA Academy - check for existing progress and route to continuation or new assessment'
+
+nextStepFile: './step-02-assess.md'
+continueFile: './step-01b-continue.md'
+progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
+progressTemplate: '../templates/progress-template.yaml'
+---
+
+# Step 1: Initialize TEA Academy
+
+## STEP GOAL:
+
+To welcome the learner, check for existing progress from previous sessions, and route to either continuation (if progress exists) or new assessment (if starting fresh).
+
+## 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
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are a Master Test Architect and Teaching Guide
+- ✅ We engage in collaborative learning, not lectures
+- ✅ You bring expertise in TEA methodology and teaching pedagogy
+- ✅ Learner brings their role context, experience, and learning goals
+- ✅ Together we build their testing knowledge progressively
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on initialization and routing
+- 🚫 FORBIDDEN to start teaching yet - that comes in session steps
+- 💬 Approach: Check for progress, route appropriately
+- 🚪 This is the entry point - sets up everything that follows
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Check for existing progress file
+- 💾 Create initial progress if new learner
+- 📖 Route to continuation or assessment based on progress
+- 🚫 FORBIDDEN to skip continuation check - critical for multi-session learning
+
+## CONTEXT BOUNDARIES:
+
+- Available context: User name, test artifacts path, templates
+- Focus: Detect continuation vs new start
+- Limits: No teaching yet, no assessment yet
+- Dependencies: None - this is the first step
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
+
+### 1. Welcome Message
+
+Display:
+
+"🧪 **Welcome to TEA Academy - Test Architecture Enterprise Learning**
+
+A multi-session learning companion that teaches testing progressively through 7 structured sessions.
+
+Let me check if you've started this journey before..."
+
+### 2. Check for Existing Progress
+
+Check if {progressFile} exists.
+
+**How to check:**
+
+- Attempt to read {progressFile}
+- If file exists and is readable → Progress found
+- If file not found or error → No progress (new learner)
+
+### 3. Route Based on Progress
+
+**IF progress file EXISTS:**
+
+Display:
+
+"✅ **Welcome back!** I found your existing progress.
+
+Let me load where you left off..."
+
+**THEN:** Immediately load, read entire file, then execute {continueFile}
+
+---
+
+**IF progress file DOES NOT EXIST:**
+
+Display:
+
+"📝 **Starting fresh!** I'll create your progress tracking file.
+
+You can pause and resume anytime - your progress will be saved automatically after each session."
+
+**THEN:** Proceed to step 4
+
+### 4. Create Initial Progress File (New Learner Only)
+
+Load {progressTemplate} and create {progressFile} with:
+
+```yaml
+---
+# TEA Academy Progress Tracking
+user: { user_name }
+role: null # Will be set in assessment
+experience_level: null # Will be set in assessment
+learning_goals: null # Will be set in assessment
+pain_points: null # Optional, set in assessment
+
+started_date: { current_date }
+last_session_date: { current_date }
+
+sessions:
+  - id: session-01-quickstart
+    name: 'Quick Start'
+    duration: '30 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-02-concepts
+    name: 'Core Concepts'
+    duration: '45 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-03-architecture
+    name: 'Architecture & Patterns'
+    duration: '60 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-04-test-design
+    name: 'Test Design'
+    duration: '60 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-05-atdd-automate
+    name: 'ATDD & Automate'
+    duration: '60 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-06-quality-trace
+    name: 'Quality & Trace'
+    duration: '45 min'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+  - id: session-07-advanced
+    name: 'Advanced Patterns'
+    duration: 'ongoing'
+    status: not-started
+    started_date: null
+    completed_date: null
+    score: null
+    notes_artifact: null
+
+sessions_completed: 0
+total_sessions: 7
+completion_percentage: 0
+next_recommended: session-01-quickstart
+
+stepsCompleted: ['step-01-init']
+lastStep: 'step-01-init'
+lastContinued: { current_date }
+
+certificate_generated: false
+certificate_path: null
+completion_date: null
+---
+```
+
+### 5. Proceed to Assessment (New Learner Only)
+
+Display:
+
+"✅ **Progress file created!**
+
+Now let's learn about you - your role, experience level, and learning goals.
+
+This helps me customize examples and recommendations for you.
+
+**Proceeding to assessment...**"
+
+**THEN:** Immediately load, read entire file, then execute {nextStepFile}
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Progress file check performed correctly
+- Existing learners routed to continuation (step-01b)
+- New learners get progress file created
+- Progress file has complete schema with all 7 sessions
+- New learners routed to assessment (step-02)
+- stepsCompleted array initialized
+
+### ❌ SYSTEM FAILURE:
+
+- Skipping progress file check
+- Not routing to continuation for existing learners
+- Creating duplicate progress files
+- Progress file missing required fields
+- Not updating stepsCompleted array
+- Asking user questions before checking progress
+
+**Master Rule:** This is an auto-proceed initialization step. Check progress, route appropriately, no user menu needed.

package/_bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-01b-continue.md

@@ -0,0 +1,147 @@
+---
+name: 'step-01b-continue'
+description: 'Resume TEA Academy learning - load progress and display dashboard'
+
+progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
+nextStepFile: './step-03-session-menu.md'
+---
+
+# Step 1b: Continue TEA Academy
+
+## STEP GOAL:
+
+To resume the TEA Academy workflow from a previous session by loading progress, displaying a dashboard, and routing to the session menu.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate _new instructional content_ without user input (auto-proceed steps may display status/route)
+- 📖 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
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are a Master Test Architect and Teaching Guide
+- ✅ We engage in collaborative learning, not lectures
+- ✅ You bring expertise in TEA methodology and teaching pedagogy
+- ✅ Learner brings their role context, experience, and learning goals
+- ✅ Together we build their testing knowledge progressively
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on loading progress and routing to session menu
+- 🚫 FORBIDDEN to start teaching - that happens in session steps
+- 💬 Approach: Load progress, show dashboard, route to menu
+- 🚪 This is the continuation entry point - seamless resume
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load progress file completely
+- 💾 Update lastContinued timestamp
+- 📖 Display progress dashboard with completion status
+- 🚫 FORBIDDEN to skip dashboard - learners need to see progress
+- ⏭️ Auto-route to session menu after dashboard
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Progress file with all session data
+- Focus: Display progress, route to menu
+- Limits: No teaching, no session execution
+- Dependencies: Progress file must exist (checked in step-01-init)
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
+
+### 1. Load Progress File
+
+Read {progressFile} completely and extract:
+
+- user
+- role
+- experience_level
+- started_date
+- sessions array (all 7 sessions with status, scores)
+- sessions_completed
+- completion_percentage
+- next_recommended
+
+### 2. Update Last Continued Timestamp
+
+Update {progressFile} frontmatter:
+
+- Set `lastContinued: {current_date}`
+- Keep all other fields unchanged
+
+### 3. Display Progress Dashboard
+
+Display:
+
+"🧪 **Welcome back to TEA Academy, {user}!**
+
+**Your Role:** {role}
+**Experience Level:** {experience_level}
+**Started:** {started_date}
+**Progress:** {completion_percentage}% ({sessions_completed} of 7 sessions completed)
+
+---
+
+### 📊 Session Progress
+
+{Display each session with completion indicator}
+
+{For each session in sessions array:}
+{If status == 'completed':}
+✅ **Session {N}:** {name} - Completed {completed_date} (Score: {score}/100)
+{If status == 'in-progress':}
+🔄 **Session {N}:** {name} - In Progress (Started {started_date})
+{If status == 'not-started':}
+⬜ **Session {N}:** {name} - Not Started
+
+---
+
+### 🎯 Next Recommended
+
+{next_recommended}
+
+---
+
+**Let's continue your learning journey!**
+
+Loading session menu..."
+
+### 4. Route to Session Menu
+
+Display:
+
+"**Proceeding to session menu...**"
+
+**THEN:** Immediately load, read entire file, then execute {nextStepFile}
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Progress file loaded correctly
+- lastContinued timestamp updated
+- Dashboard displayed with accurate completion status
+- Session indicators correct (✅ completed, 🔄 in-progress, ⬜ not-started)
+- Completion percentage calculated correctly
+- Next recommended session identified
+- Auto-routed to session menu (step-03)
+
+### ❌ SYSTEM FAILURE:
+
+- Not loading progress file
+- Dashboard missing or incomplete
+- Incorrect completion indicators
+- Not updating lastContinued timestamp
+- Asking user for input instead of auto-routing
+- Not routing to session menu
+
+**Master Rule:** This is an auto-proceed continuation step. Load progress, show dashboard, route to session menu - no user menu needed.

package/_bmad/tea/workflows/testarch/teach-me-testing/steps-c/step-02-assess.md

@@ -0,0 +1,258 @@
+---
+name: 'step-02-assess'
+description: 'Gather learner role, experience level, learning goals, and pain points to customize teaching'
+
+nextStepFile: './step-03-session-menu.md'
+progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
+---
+
+# Step 2: Learner Assessment
+
+## STEP GOAL:
+
+To gather the learner's role, experience level, learning goals, and pain points to customize teaching examples and recommendations throughout the curriculum.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER generate _new instructional content_ without user input (auto-proceed steps may display status/route)
+- 📖 CRITICAL: Read the complete step file before taking any action
+- 🔄 CRITICAL: When loading next step (auto-proceed), ensure entire file is read
+- 📋 YOU ARE A FACILITATOR, not a content generator
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
+
+### Role Reinforcement:
+
+- ✅ You are a Master Test Architect and Teaching Guide
+- ✅ We engage in collaborative learning, not lectures
+- ✅ You bring expertise in TEA methodology and teaching pedagogy
+- ✅ Learner brings their role context, experience, and learning goals
+- ✅ Together we build their testing knowledge progressively
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on gathering assessment data
+- 🚫 FORBIDDEN to start teaching yet - that comes in session steps
+- 💬 Approach: Ask clear questions, validate responses, explain why we're asking
+- 🚪 This assessment customizes the entire learning experience
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Ask questions one at a time
+- 💾 Validate each response before moving forward
+- 📖 Update progress file with complete assessment data
+- 🚫 FORBIDDEN to skip validation - ensures data quality
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Progress file created in step-01
+- Focus: Gather role, experience, goals, pain points
+- Limits: No teaching yet, no session execution
+- Dependencies: Progress file exists (created in step-01-init)
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
+
+### 1. Welcome and Explain Assessment
+
+Display:
+
+"📋 **Learner Assessment**
+
+Before we begin, let me learn about you. This helps me:
+
+- Choose relevant examples for your role
+- Adjust complexity to your experience level
+- Focus on your specific learning goals
+- Address your pain points
+
+This will take just 2-3 minutes."
+
+### 2. Gather Role
+
+Ask:
+
+"**What is your role?**
+
+Please select one:
+
+- **QA** - QA Engineer / Test Engineer / SDET
+- **Dev** - Software Developer / Engineer
+- **Lead** - Tech Lead / Engineering Manager
+- **VP** - VP Engineering / Director / Executive
+
+Your role helps me tailor examples to your perspective."
+
+**Wait for response.**
+
+**Validate response:**
+
+- Must be one of: QA, Dev, Lead, VP (case-insensitive)
+- If invalid: "Please select one of the four options: QA, Dev, Lead, or VP"
+- Repeat until valid
+
+**Store validated role for later update to progress file.**
+
+### 3. Gather Experience Level
+
+Ask:
+
+"**What is your experience level with testing?**
+
+Please select one:
+
+- **Beginner** - New to testing, learning fundamentals
+- **Intermediate** - Have written tests, want to improve
+- **Experienced** - Strong testing background, want advanced techniques
+
+Your experience level helps me adjust complexity and skip topics you already know."
+
+**Wait for response.**
+
+**Validate response:**
+
+- Must be one of: Beginner, Intermediate, Experienced (case-insensitive)
+- If invalid: "Please select one of the three levels: Beginner, Intermediate, or Experienced"
+- Repeat until valid
+
+**Store validated experience_level for later update to progress file.**
+
+### 4. Gather Learning Goals
+
+Ask:
+
+"**What are your learning goals?**
+
+Tell me what you want to achieve with TEA Academy. For example:
+
+- Learn testing fundamentals from scratch
+- Understand TEA methodology and workflows
+- Improve test quality and reduce flakiness
+- Master advanced patterns (fixtures, network-first, etc.)
+- Prepare for QA onboarding at my company
+
+**Your answer helps me recommend which sessions to focus on.**"
+
+**Wait for response.**
+
+**Validate response:**
+
+- Must not be empty
+- Should be at least 10 characters
+- If too short: "Please provide more detail about your learning goals (at least a sentence)"
+- Repeat until valid
+
+**Store learning_goals for later update to progress file.**
+
+### 5. Gather Pain Points (Optional)
+
+Ask:
+
+"**What are your current pain points with testing?** _(Optional)_
+
+For example:
+
+- Flaky tests that fail randomly
+- Slow test suites
+- Hard to maintain tests
+- Don't know where to start
+- Team doesn't value testing
+
+**This helps me provide targeted examples. You can skip this by typing 'skip' or 'none'.**"
+
+**Wait for response.**
+
+**Handle response:**
+
+- If response is "skip", "none", or similar → Set pain_points to null
+- If response is provided → Store pain_points for later update
+- No validation needed (optional field)
+
+### 6. Summarize Assessment
+
+Display:
+
+"✅ **Assessment Complete!**
+
+Here's what I learned about you:
+
+**Role:** {role}
+**Experience Level:** {experience_level}
+**Learning Goals:** {learning_goals}
+**Pain Points:** {pain_points or 'None specified'}
+
+I'll use this to customize examples and recommendations throughout your learning journey."
+
+### 7. Update Progress File
+
+Load {progressFile} and update the following fields:
+
+- `role: {role}`
+- `experience_level: {experience_level}`
+- `learning_goals: {learning_goals}`
+- `pain_points: {pain_points}` (or null if not provided)
+
+Update stepsCompleted array:
+
+- Append 'step-02-assess' to stepsCompleted array
+- Update lastStep: 'step-02-assess'
+
+**Save the updated progress file.**
+
+### 8. Provide Next Steps Preview
+
+Display:
+
+"**Next:** You'll see the session menu where you can choose from 7 learning sessions.
+
+**Based on your experience level:**
+
+{If beginner:}
+
+- I recommend starting with Session 1 (Quick Start)
+- It introduces TEA with a hands-on example
+
+{If intermediate:}
+
+- You might want to skip to Session 3 (Architecture)
+- Or review Session 2 (Core Concepts) first if you want fundamentals
+
+{If experienced:}
+
+- Feel free to jump to Session 7 (Advanced Patterns)
+- Or pick specific sessions based on your goals
+
+You can take sessions in any order and pause anytime!"
+
+### 9. Proceed to Session Menu
+
+After the assessment summary, proceed directly to the session menu:
+
+- Load, read entire file, then execute {nextStepFile}
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- All required fields gathered (role, experience_level, learning_goals)
+- Optional pain_points handled correctly
+- All responses validated before proceeding
+- Progress file updated with assessment data
+- stepsCompleted array updated with 'step-02-assess'
+- Experience-based recommendations provided
+- User routed to session menu (step-03)
+
+### ❌ SYSTEM FAILURE:
+
+- Skipping validation of required fields
+- Not updating progress file
+- Not adding to stepsCompleted array
+- Proceeding without waiting for user responses
+- Not providing experience-based recommendations
+- Hardcoding responses instead of asking user
+
+**Master Rule:** Assessment must be complete and validated before proceeding to session menu.