bmad-studio 0.1.0 → 0.2.0

package/_bmad/tea/workflows/testarch/bmad-teach-me-testing/instructions.md

@@ -1,130 +0,0 @@
-# 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/_bmad/tea/workflows/testarch/bmad-teach-me-testing/steps-c/step-01-init.md

@@ -1,235 +0,0 @@
----
-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/bmad-teach-me-testing/steps-c/step-01b-continue.md

@@ -1,147 +0,0 @@
----
-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.