ma-agents 2.19.2 → 2.20.0

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/instructions.md

@@ -0,0 +1,130 @@
+# Teach Me Testing - Usage Instructions
+
+## Overview
+
+The Teach Me Testing workflow is a multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence. Designed for self-paced learning over 1-2 weeks.
+
+## Who Should Use This
+
+- **New QA Engineers:** Complete onboarding in testing fundamentals
+- **Developers:** Learn testing from an integration perspective
+- **Team Leads:** Understand architecture patterns and team practices
+- **VPs/Managers:** Grasp testing strategy and quality metrics
+
+## How to Run
+
+### Starting Fresh
+
+```bash
+# From TEA module location
+cd /path/to/bmad-method-test-architecture-enterprise
+
+# Run the workflow
+bmad run teach-me-testing
+```
+
+Or invoke through TEA agent menu:
+
+```bash
+bmad agent tea
+# Select [TMT] Teach Me Testing
+```
+
+### Continuing Existing Progress
+
+The workflow automatically detects existing progress and resumes where you left off. Your progress is saved at:
+
+- `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
+
+## Workflow Structure
+
+### 7 Sessions
+
+1. **Quick Start (30 min)** - TEA Lite intro, run automate workflow
+2. **Core Concepts (45 min)** - Risk-based testing, DoD, philosophy
+3. **Architecture (60 min)** - Fixtures, network patterns, framework
+4. **Test Design (60 min)** - Risk assessment workflow
+5. **ATDD & Automate (60 min)** - ATDD + Automate workflows
+6. **Quality & Trace (45 min)** - Test review + Trace workflows
+7. **Advanced Patterns (ongoing)** - Menu-driven knowledge fragment exploration
+
+### Non-Linear Learning
+
+- Jump to any session based on your experience level
+- Beginners: Start at Session 1
+- Intermediate: Skip to Session 3-6
+- Experienced: Jump to Session 7 (Advanced)
+
+### Session Flow
+
+Each session follows this pattern:
+
+1. Load relevant TEA docs just-in-time
+2. Present teaching content (mostly autonomous)
+3. Knowledge validation quiz (interactive)
+4. Generate session notes artifact
+5. Update progress file
+6. Return to session menu (continue or exit)
+
+## Progress Tracking
+
+Your progress is automatically saved after each session:
+
+- **Progress file:** `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
+- **Session notes:** `{test_artifacts}/tea-academy/{your-name}/session-{N}-notes.md`
+- **Certificate:** `{test_artifacts}/tea-academy/{your-name}/tea-completion-certificate.md`
+
+## Quiz Scoring
+
+- **Passing threshold:** ≥70%
+- **On failure:** Option to review content or continue anyway
+- **Attempts:** 3 attempts per question before showing correct answer
+
+## Completion
+
+Complete all 7 sessions to receive your TEA Academy completion certificate with:
+
+- Session completion dates and scores
+- Skills acquired checklist
+- Learning artifacts paths
+- Recommended next steps
+
+## Tips for Success
+
+1. **Set aside dedicated time** - Each session requires focus (30-90 min)
+2. **Take notes** - Session notes are generated, but add your own insights
+3. **Apply immediately** - Practice concepts on your current project
+4. **Explore fragments** - Session 7 has 35 knowledge fragments to deep-dive
+5. **Share with team** - Help others learn by sharing your experience
+
+## Customization by Role
+
+The workflow adapts examples based on your role:
+
+- **QA:** Practical testing focus, workflow usage
+- **Dev:** Integration perspective, TDD approach
+- **Lead:** Architecture decisions, team patterns
+- **VP:** Strategy, ROI, quality metrics
+
+## Troubleshooting
+
+### Progress file corrupted
+
+- Workflow detects corruption and offers fresh start
+- Backup file created automatically
+
+### Missing TEA docs
+
+- Workflow uses Web-Browsing fallback for external frameworks
+- Primary source is always local docs
+
+### Session interrupted
+
+- Progress auto-saved after quiz completion
+- Resume from session menu on next run
+
+## Support
+
+- **Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
+- **Knowledge Fragments:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge>
+- **Issues:** Report via TEA module repository

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-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/lib/bmad-cache/tea/src/workflows/testarch/bmad-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.