sar/.agents/skills/bmad-teach-me-testing/instructions.md

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

# 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:

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

Step Entrypoints

• Create / start: {skill-root}/steps-c/step-01-init.md
• Continue existing progress: {skill-root}/steps-c/step-01b-continue.md
• Validate the workflow: {skill-root}/steps-v/step-v-01-validate.md
• Edit the workflow: {skill-root}/steps-e/step-e-01-assess-workflow.md

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 42 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/agents/bmad-tea/resources/knowledge
• Issues: Report via TEA module repository