ma-agents 2.19.2 → 2.20.0

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/steps-v/step-v-01-validate.md

@@ -0,0 +1,263 @@
+---
+name: 'step-v-01-validate'
+description: 'Validate teach-me-testing workflow quality against BMAD standards'
+
+workflowPath: '../'
+checklistFile: '../checklist.md'
+validationReport: '{test_artifacts}/workflow-validation/teach-me-testing-validation-{date}.md'
+---
+
+# Validate Step 1: Quality Validation
+
+## STEP GOAL:
+
+To systematically validate the teach-me-testing workflow against BMAD quality standards and generate a comprehensive validation report.
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+### Universal Rules:
+
+- 🛑 NEVER skip validation checks
+- 📖 CRITICAL: Read complete step file before action
+- ✅ SPEAK OUTPUT In {communication_language}
+
+### Role Reinforcement:
+
+- ✅ You are a workflow quality assurance specialist
+- ✅ Systematic validation against standards
+
+### Step-Specific Rules:
+
+- 🎯 Focus on comprehensive validation
+- 🚫 FORBIDDEN to skip any checks
+- 💬 Report findings clearly
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Run all validation checks
+- 💾 Generate validation report
+- 📖 Provide remediation guidance
+
+## MANDATORY SEQUENCE
+
+### 1. Validation Start
+
+"**Validating Workflow: teach-me-testing**
+
+Running comprehensive quality checks against BMAD standards...
+
+This will validate:
+
+- Foundation structure
+- Step file quality (12 CREATE, 2 EDIT, 1 VALIDATE)
+- Template quality
+- Data file completeness
+- Frontmatter compliance
+- Menu handling patterns
+- State management
+- Documentation
+
+**Starting validation...**"
+
+### 2. Foundation Structure Validation
+
+**Check:**
+
+- [ ] workflow.md exists with proper frontmatter
+- [ ] Tri-modal routing logic present
+- [ ] Configuration loading correct
+- [ ] First step path correct
+- [ ] Folder structure complete (steps-c/, steps-e/, steps-v/, data/, templates/)
+
+Report findings: Pass/Fail for each check.
+
+### 3. Template Validation
+
+**Check templates/:**
+
+- [ ] progress-template.yaml has complete schema
+- [ ] All 7 sessions defined
+- [ ] Session status fields present
+- [ ] stepsCompleted array present
+- [ ] session-notes-template.md has required sections
+- [ ] certificate-template.md includes all 7 sessions
+
+Report findings.
+
+### 4. Step File Validation (CREATE Mode)
+
+**For each of 12 steps in steps-c/:**
+
+- [ ] Frontmatter valid (name, description present)
+- [ ] All frontmatter variables used in body
+- [ ] File references use relative paths correctly
+- [ ] Menu handling follows standards
+- [ ] Step goal clearly stated
+- [ ] MANDATORY SEQUENCE present
+- [ ] Success/failure metrics present
+- [ ] File size reasonable (<250 lines recommended)
+
+Report findings per step.
+
+### 5. Data File Validation
+
+**Check data/:**
+
+- [ ] curriculum.yaml defines all 7 sessions
+- [ ] role-paths.yaml has all 4 roles (QA/Dev/Lead/VP)
+- [ ] session-content-map.yaml maps sessions to resources
+- [ ] quiz-questions.yaml has questions for sessions 1-6
+- [ ] tea-resources-index.yaml has complete documentation index
+
+Report findings.
+
+### 6. Content Quality Validation
+
+**Check session steps:**
+
+- [ ] Teaching content present and comprehensive
+- [ ] Role-adapted examples present
+- [ ] Quiz questions validate understanding
+- [ ] TEA resource references correct
+- [ ] Knowledge fragment references accurate
+- [ ] Online URLs functional
+
+Report findings.
+
+### 7. State Management Validation
+
+**Check continuable workflow features:**
+
+- [ ] step-01-init checks for existing progress
+- [ ] step-01b-continue loads and displays progress
+- [ ] All session steps update stepsCompleted array
+- [ ] Progress file schema matches template
+- [ ] Session menu reads progress correctly
+- [ ] Completion step verifies all sessions done
+
+Report findings.
+
+### 8. User Experience Validation
+
+**Check UX:**
+
+- [ ] Clear navigation instructions
+- [ ] Progress visibility (percentage, indicators)
+- [ ] Auto-save after sessions
+- [ ] Resume capability
+- [ ] Exit options clear
+- [ ] Session descriptions helpful
+
+Report findings.
+
+### 9. Generate Validation Report
+
+Create {validationReport}:
+
+```markdown
+---
+workflow: teach-me-testing
+validation_date: { current_date }
+validator: TEA Validation Workflow
+overall_status: PASS / FAIL / PASS_WITH_WARNINGS
+---
+
+# Teach Me Testing - Validation Report
+
+**Date:** {current_date}
+**Workflow Version:** 1.0.0
+**Overall Status:** {status}
+
+---
+
+## Validation Summary
+
+**Total Checks:** {count}
+**Passed:** {pass_count}
+**Failed:** {fail_count}
+**Warnings:** {warning_count}
+
+**Overall Quality Score:** {score}/100
+
+---
+
+## Foundation Structure
+
+{Report findings}
+
+## Template Quality
+
+{Report findings}
+
+## Step File Quality
+
+{Report findings for all 15 steps}
+
+## Data File Quality
+
+{Report findings}
+
+## Content Quality
+
+{Report findings}
+
+## State Management
+
+{Report findings}
+
+## User Experience
+
+{Report findings}
+
+---
+
+## Issues Found
+
+{List all failures and warnings}
+
+---
+
+## Remediation Recommendations
+
+{For each issue, provide fix guidance}
+
+---
+
+## Conclusion
+
+{Overall assessment}
+
+**Status:** {READY_FOR_PRODUCTION / NEEDS_FIXES / PASS_WITH_MINOR_ISSUES}
+```
+
+### 10. Display Results
+
+"**Validation Complete!**
+
+**Overall Status:** {status}
+**Quality Score:** {score}/100
+
+**Report saved:** {validationReport}
+
+{If PASS:}
+✅ **Workflow is ready for production!**
+
+{If FAIL:}
+❌ **Issues found that need fixing.**
+See report for details: {validationReport}
+
+{If WARNINGS:}
+⚠️ **Minor issues found.**
+Workflow is usable but could be improved.
+
+**Validation report generated.**"
+
+**This is the final validation step - workflow ends here.**
+
+---
+
+## 🚨 SUCCESS METRICS
+
+✅ All validation checks run, comprehensive report generated, issues identified with remediation guidance, overall status determined.
+
+**Master Rule:** Check everything systematically, report findings clearly, provide actionable remediation.

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/templates/certificate-template.md

@@ -0,0 +1,86 @@
+---
+certificate_type: tea-academy-completion
+user: { { user_name } }
+role: { { role } }
+completion_date: { { completion_date } }
+started_date: { { started_date } }
+total_duration: { { total_duration } }
+average_score: { { average_score } }
+---
+
+# 🏆 TEA Academy Completion Certificate
+
+---
+
+## Certificate of Completion
+
+**This certifies that**
+
+## {{user_name}}
+
+**has successfully completed the TEA Academy testing curriculum**
+
+---
+
+### Program Details
+
+**Role:** {{role}}
+**Started:** {{started_date}}
+**Completed:** {{completion_date}}
+**Total Duration:** {{total_duration}}
+**Average Score:** {{average_score}}/100
+
+---
+
+### Sessions Completed
+
+✅ **Session 1:** Quick Start (30 min) - Score: {{session_01_score}}
+✅ **Session 2:** Core Concepts (45 min) - Score: {{session_02_score}}
+✅ **Session 3:** Architecture & Patterns (60 min) - Score: {{session_03_score}}
+✅ **Session 4:** Test Design (60 min) - Score: {{session_04_score}}
+✅ **Session 5:** ATDD & Automate (60 min) - Score: {{session_05_score}}
+✅ **Session 6:** Quality & Trace (45 min) - Score: {{session_06_score}}
+✅ **Session 7:** Advanced Patterns (ongoing) - Score: {{session_07_score}}
+
+---
+
+### Skills Acquired
+
+{{user_name}} has demonstrated proficiency in:
+
+- ✅ **Testing Fundamentals:** Risk-based testing, test pyramid, test types
+- ✅ **TEA Methodology:** 9 workflows, engagement models, quality standards
+- ✅ **Architecture Patterns:** Fixtures, network-first patterns, data factories
+- ✅ **Test Design:** Risk assessment, coverage planning, P0-P3 prioritization
+- ✅ **Test Development:** ATDD red-green approach, test automation
+- ✅ **Quality Assurance:** Test review, traceability, NFR assessment
+- ✅ **Advanced Techniques:** 35 knowledge fragments explored
+
+---
+
+### Learning Artifacts
+
+All session notes and progress tracking available at:
+`{{artifacts_path}}`
+
+---
+
+### Next Steps
+
+**Recommended Actions:**
+
+1. Apply TEA principles to current project
+2. Run TEA workflows (Framework, Test Design, ATDD, Automate)
+3. Share knowledge with team members
+4. Continue exploring knowledge fragments as needed
+5. Contribute to TEA methodology improvements
+
+---
+
+**Generated by:** TEA Academy - Teach Me Testing Workflow
+**Module:** Test Architecture Enterprise (TEA)
+**Website:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
+
+---
+
+🧪 **Master Test Architect and Quality Advisor**

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/templates/progress-template.yaml

@@ -0,0 +1,95 @@
+---
+# TEA Academy Progress Tracking
+# This file tracks a learner's progress through the teaching workflow
+
+# User Information
+user: "{{user_name}}"
+role: "{{role}}" # qa | dev | lead | vp
+experience_level: "{{experience_level}}" # beginner | intermediate | experienced
+learning_goals: "{{learning_goals}}"
+pain_points: "{{pain_points}}" # optional
+
+# Session Tracking
+started_date: "{{current_date}}"
+last_session_date: "{{current_date}}"
+
+# Session Array - tracks completion status for all 7 sessions
+sessions:
+  - id: session-01-quickstart
+    name: "Quick Start"
+    duration: "30 min"
+    status: not-started # not-started | in-progress | completed
+    started_date: null
+    completed_date: null
+    score: null # 0-100
+    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
+
+# Progress Metrics
+sessions_completed: 0
+total_sessions: 7
+completion_percentage: 0
+next_recommended: session-01-quickstart
+
+# Workflow Continuation Tracking (for continuable workflow)
+stepsCompleted: []
+lastStep: ""
+lastContinued: ""
+
+# Completion Certificate
+certificate_generated: false
+certificate_path: null
+completion_date: null

package/lib/bmad-cache/tea/src/workflows/testarch/bmad-teach-me-testing/templates/session-notes-template.md

@@ -0,0 +1,83 @@
+---
+session_id: { { session_id } }
+session_name: { { session_name } }
+user: { { user_name } }
+role: { { role } }
+completed_date: { { completed_date } }
+score: { { score } }
+duration: { { duration } }
+---
+
+# {{session_name}} - Session Notes
+
+**Learner:** {{user_name}} ({{role}})
+**Completed:** {{completed_date}}
+**Score:** {{score}}/100
+**Duration:** {{duration}}
+
+---
+
+## Session Objectives
+
+{{session_objectives}}
+
+---
+
+## Key Concepts Covered
+
+{{key_concepts}}
+
+---
+
+## TEA Resources Referenced
+
+### Documentation
+
+{{docs_referenced}}
+
+### Knowledge Fragments
+
+{{knowledge_fragments_referenced}}
+
+### Online Resources
+
+{{online_resources}}
+
+---
+
+## Quiz Results
+
+**Score:** {{score}}/100
+
+### Questions & Answers
+
+{{quiz_results}}
+
+---
+
+## Practical Examples
+
+{{practical_examples}}
+
+---
+
+## Key Takeaways
+
+{{key_takeaways}}
+
+---
+
+## Next Recommended Session
+
+{{next_recommended}}
+
+---
+
+## Additional Notes
+
+{{additional_notes}}
+
+---
+
+**Generated by:** TEA Academy - Teach Me Testing Workflow
+**Session Path:** Session {{session_number}} of 7