initial commit

2026-03-16 19:54:53 -04:00
commit bfe0e01254
3341 changed files with 483939 additions and 0 deletions
--- a/.claude/skills/bmad-teach-me-testing/workflow-plan-teach-me-testing.md
+++ b/.claude/skills/bmad-teach-me-testing/workflow-plan-teach-me-testing.md
@@ -0,0 +1,950 @@
+---
+stepsCompleted:
+  [
+    'step-01-discovery',
+    'step-02-classification',
+    'step-03-requirements',
+    'step-04-tools',
+    'step-05-plan-review',
+    'step-06-design',
+    'step-07-foundation',
+  ]
+created: 2026-01-27
+status: FOUNDATION_COMPLETE
+approvedDate: 2026-01-27
+designCompletedDate: 2026-01-27
+foundationCompletedDate: 2026-01-28
+---
+
+# Workflow Creation Plan
+
+## Discovery Notes
+
+**User's Vision:**
+Create an ongoing learning companion that teaches testing progressively through a structured curriculum. Users at the company (and beyond) lack testing knowledge regardless of experience level - from hobbyist beginners to experienced VPs. The TEA (Test Architecture Enterprise) module has extensive documentation (~24k lines, 200 files, 9 workflows, 35 knowledge fragments), but manual teaching doesn't scale. This workflow solves that by providing self-paced, structured learning with state persistence across multiple sessions.
+
+**Who It's For:**
+
+- New QA engineers (primary onboarding use case)
+- Developers who need testing knowledge
+- Anyone at the company requiring testing fundamentals through advanced practices
+- Scalable to entire team without manual teaching
+
+**What It Produces:**
+
+- Multi-session learning journey (7 sessions, 30-90 min each)
+- Session-by-session progress tracking via persistent state file
+- Learning artifacts: session notes, test files, reports, completion certificate
+- Personalized learning paths customized by role (QA vs Dev vs Lead vs VP)
+- Knowledge validation through quizzes after each session
+- Resume capability - users can pause and continue across days/weeks
+
+**Key Insights:**
+
+- Content volume (~24k lines) makes single-session teaching infeasible
+- State persistence is critical for multi-session continuity
+- Just-in-time content loading per session keeps context manageable
+- First use case: new QA onboarding completing in 1-2 weeks
+- Workflow must reference and integrate TEA docs and knowledge base extensively
+- Users learn at their own pace without requiring instructor availability
+
+**Technical Architecture Requirements:**
+
+- 7-session curriculum structure
+- State file: tracks progress, scores, completed sessions, artifacts, next recommended session
+- Role-based path customization
+- Knowledge validation gates between sessions
+- Artifact generation per session
+- Integration with TEA module documentation and knowledge base
+
+## Classification Decisions
+
+**Workflow Name:** teach-me-testing
+**Target Path:** {project-root}/src/workflows/testarch/bmad-teach-me-testing/
+
+**4 Key Decisions:**
+
+1. **Document Output:** Yes (produces progress files, session notes, artifacts, completion certificate)
+2. **Module Affiliation:** TEA module (9th workflow in test architecture)
+3. **Session Type:** Continuable (multi-session learning over 1-2 weeks)
+4. **Lifecycle Support:** Tri-modal (Create + Edit + Validate for future-proofing)
+
+**Structure Implications:**
+
+- **Tri-modal architecture:** Needs `steps-c/`, `steps-e/`, `steps-v/` folders
+- **Continuable workflow:** Requires `step-01-init.md` with continuation detection + `step-01b-continue.md` for resuming
+- **State tracking:** Uses `stepsCompleted` in progress file frontmatter
+- **Document templates:** Progress tracking YAML, session notes markdown, completion certificate
+- **Module integration:** Access to TEA module variables, docs paths, knowledge base paths
+- **Data folder:** Shared data for curriculum structure, role paths, session content mappings
+
+## Requirements
+
+**Flow Structure:**
+
+- Pattern: Mixed (non-linear between sessions, linear within sessions, branching at start only)
+- Phases: Initial assessment → Session selection (non-linear) → Session execution (linear: teach → quiz → artifact) → Completion
+- Estimated steps: Init + Continue + Assessment + 7 Session steps + Final Polish/Certificate generation = ~10-12 core step files
+- Session jumping: Users can skip to any session based on experience level
+- Within session: Strictly linear progression through teaching content
+
+**User Interaction:**
+
+- Style: Mixed (mostly autonomous teaching with collaborative decision points)
+- Decision points:
+  - Role/experience assessment (entry)
+  - Session selection (menu-driven, can jump around)
+  - Quiz answers (validation gates)
+  - Continue to next session or exit
+- Checkpoint frequency: At session completion (save progress, offer continue/exit)
+- Teaching approach: AI presents content, user absorbs - minimal interruption once learning
+
+**Inputs Required:**
+
+- Required:
+  - User role (QA, Dev, Lead, VP)
+  - Experience level (beginner, intermediate, experienced)
+  - Learning goals (fundamentals, TEA-specific, advanced patterns)
+- Optional:
+  - Existing project for practical examples
+  - Specific pain points (flaky tests, slow tests, hard to maintain)
+- Prerequisites:
+  - TEA module installed
+  - Access to TEA docs and knowledge base
+  - Understanding of time commitment (30-90 min per session)
+
+**Output Specifications:**
+
+- Type: Multiple document types
+- Format: Mixed formats
+  - Progress file: Structured YAML with specific schema (sessions, scores, artifacts, completed_date, next_recommended)
+  - Session notes: Free-form markdown built progressively per session
+  - Completion certificate: Structured format with completion data
+- Sections:
+  - Progress file has fixed schema
+  - Session notes vary by session content
+  - Certificate has standard completion fields
+- Frequency:
+  - Progress file: Updated after each session
+  - Session notes: Generated per session
+  - Certificate: Generated at final completion
+
+**Success Criteria:**
+
+- User completes their chosen sessions (might be 1, might be all 7)
+- Knowledge validated through quizzes (≥70% passing threshold)
+- Artifacts generated successfully (progress file exists, session notes created, learning tracked)
+- User can apply knowledge (write their first good test following TEA principles)
+- Onboarding velocity achieved (new QAs complete core sessions within 1-2 weeks)
+- Scalability proven (multiple team members learn without requiring instructor time)
+
+**Instruction Style:**
+
+- Overall: Mixed (prescriptive for structure, intent-based for teaching)
+- Prescriptive for:
+  - Initial assessment (consistent role/experience classification)
+  - Quiz questions (need exact validation logic)
+  - Progress tracking (exact state file updates)
+  - Session navigation (clear menu structure)
+- Intent-based for:
+  - Teaching sessions (AI adapts explanations naturally)
+  - Example selection (AI chooses relevant TEA docs/knowledge fragments)
+  - Artifact generation (AI synthesizes learning into notes)
+  - Role-flavored content (AI adjusts examples based on user role)
+
+## Tools Configuration
+
+**Core BMAD Tools:**
+
+- **Party Mode:** Included (optional via A/P menu) - Use for collaborative exploration when the learner wants a lighter format
+- **Advanced Elicitation:** Included (optional via A/P menu) - Use for deeper discovery or clarification during sessions
+- **Brainstorming:** Excluded - Not needed for structured curriculum delivery
+
+**LLM Features:**
+
+- **Web-Browsing:** Included - Use case: Safety net for framework updates (Cypress, Jest, newer Playwright versions) and frameworks not covered in TEA docs. Motto: "Only reach out when you don't have the info"
+- **File I/O:** Included - Operations: Read TEA docs (/docs/_.md), read knowledge fragments (/src/testarch/knowledge/_.md), write progress file ({user}-tea-progress.yaml), write session notes, write completion certificate
+- **Sub-Agents:** Excluded - Sessions are linear teaching steps handled by TEA agent, not complex specialized tasks requiring delegation
+- **Sub-Processes:** Excluded - Learning is sequential (one session at a time), no parallel processing needed
+
+**Memory:**
+
+- Type: Continuable workflow with persistent state
+- Tracking:
+  - `stepsCompleted` array in progress YAML
+  - Session completion tracking (id, status, completed_date, score, artifacts)
+  - Progress metrics (completion_percentage, next_recommended)
+  - Progress file structure:
+    ```yaml
+    user: { user_name }
+    role: { qa/dev/lead/vp }
+    sessions: [{ id, status, completed_date, score, artifacts }]
+    completion_percentage: { percent }
+    next_recommended: { session-id }
+    ```
+  - Continuation support via step-01b-continue.md with progress dashboard
+
+**External Integrations:**
+
+- None - Self-contained within TEA module, no external databases/APIs/MCP servers needed
+
+**Installation Requirements:**
+
+- None - All selected tools are built-in (Web-Browsing and File I/O are standard LLM features)
+- User preference: N/A (no installations required)
+
+## Workflow Design
+
+### Complete Flow Overview
+
+**Entry → Init (check for progress) → [New User: Assessment | Returning User: Dashboard] → Session Menu (hub) → Sessions 1-7 (loop back to menu) → Completion Certificate**
+
+### Step Structure (CREATE mode - steps-c/)
+
+**Total: 12 step files**
+
+#### Phase 1: Initialization & Continuation
+
+1. **step-01-init.md** (Init Step - Continuable)
+   - Goal: Welcome user, check for existing progress file, explain workflow, create initial progress if new
+   - Type: Init (Continuable) - checks for `{user}-tea-progress.yaml`, routes to step-01b if exists
+   - Menu: Auto-proceed (Pattern 3) - no user menu
+   - Logic: Checks for existing progress → routes to step-01b if exists, otherwise creates new and proceeds to step-02
+
+2. **step-01b-continue.md** (Continuation Step)
+   - Goal: Load existing progress, show dashboard with completion status, route to session menu
+   - Type: Continuation - reads `stepsCompleted`, displays progress percentage
+   - Menu: Auto-proceed (Pattern 3) - no user menu
+   - Logic: Shows progress dashboard → auto-routes to step-03-session-menu
+
+#### Phase 2: Assessment & Path Selection
+
+3. **step-02-assess.md** (Middle Step - Standard)
+   - Goal: Gather role (QA/Dev/Lead/VP), experience level, learning goals, optional pain points
+   - Type: Middle (Standard) auto-proceed
+   - Menu: Auto-proceed (Pattern 3) - no user menu
+   - On completion: Saves assessment to progress file → loads step-03-session-menu
+
+4. **step-03-session-menu.md** (Branch Step - Hub)
+   - Goal: Present 7 sessions with descriptions + completion status, allow non-linear selection
+   - Type: Branch Step (custom menu: 1-7, X for exit)
+   - Menu: Custom branching (Pattern 4)
+   - Display: [1-7] Select session | [X] Exit
+   - Logic:
+     - 1-7: Routes to corresponding session step
+     - X: If all sessions complete → routes to step-05-completion; if incomplete → saves and exits
+   - **This is the hub - all sessions return here**
+
+#### Phase 3: Session Execution (7 Sessions)
+
+5-11. **step-04-session-[01-07].md** (Middle Steps - Complex)
+
+- Each session follows same pattern:
+  - Loads relevant TEA docs just-in-time
+  - Presents teaching content (mostly autonomous)
+  - Knowledge validation quiz (collaborative)
+  - Generates session notes artifact
+  - Updates progress file
+  - Returns to step-03-session-menu
+- Menu: Standard A/P/C (Pattern 1) - users might want Advanced Elicitation
+- On C: Saves session notes, updates progress (mark complete, update score), returns to hub
+
+**Sessions:**
+
+- **session-01**: Quick Start (30 min) - TEA Lite intro, run automate workflow
+- **session-02**: Core Concepts (45 min) - Risk-based testing, DoD, philosophy
+- **session-03**: Architecture (60 min) - Fixtures, network patterns, framework
+- **session-04**: Test Design (60 min) - Risk assessment workflow
+- **session-05**: ATDD & Automate (60 min) - ATDD + Automate workflows
+- **session-06**: Quality & Trace (45 min) - Test review + Trace workflows
+- **session-07**: Advanced Patterns (ongoing) - Menu-driven knowledge fragment exploration
+
+#### Phase 4: Completion
+
+12. **step-05-completion.md** (Final Step)
+    - Goal: Generate completion certificate, final progress update, congratulate
+    - Type: Final - no nextStepFile, marks workflow complete
+    - Menu: None (final step)
+    - Logic: Generates certificate, displays congratulations, workflow ends
+
+### Interaction Patterns
+
+- **Auto-proceed steps:** step-01-init, step-01b-continue, step-02-assess
+- **Standard A/P/C:** step-04-session-[01-07]
+- **Custom branching:** step-03-session-menu (hub)
+- **No menu:** step-05-completion (final)
+
+### Data Flow
+
+**Progress File:** `{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml`
+
+**Schema:**
+
+```yaml
+user: { user_name }
+role: { qa/dev/lead/vp }
+experience_level: { beginner/intermediate/experienced }
+learning_goals: [list]
+pain_points: [optional list]
+started_date: 2026-01-27
+last_session_date: 2026-01-27
+
+sessions:
+  - id: session-01-quickstart
+    status: completed
+    completed_date: 2026-01-27
+    score: 90
+    notes_artifact: '{test_artifacts}/tea-academy/{user_name}/session-01-notes.md'
+  - id: session-02-concepts
+    status: in-progress
+    started_date: 2026-01-27
+  # ... sessions 03-07
+
+sessions_completed: 1
+total_sessions: 7
+completion_percentage: 14
+next_recommended: session-02-concepts
+
+stepsCompleted: ['step-01-init', 'step-02-assess', 'step-04-session-01']
+lastStep: 'step-04-session-01'
+lastContinued: '2026-01-27'
+```
+
+**Data Flow Per Step:**
+
+- **step-01-init:** Creates initial progress YAML if new
+- **step-01b-continue:** Reads progress file, updates lastContinued
+- **step-02-assess:** Updates role, experience, goals, pain_points
+- **step-03-session-menu:** Reads sessions array (display status)
+- **step-04-session-[N]:** Reads progress (for role), writes session notes, updates sessions array
+- **step-05-completion:** Reads all sessions data, writes certificate
+
+**Error Handling:**
+
+- Quiz failure (<70%): Offer review or continue anyway
+- Missing TEA docs: Use Web-Browsing fallback
+- Corrupted progress: Backup and offer fresh start
+- Session interrupted: Auto-save after quiz completion
+
+**Checkpoints:**
+
+- After assessment complete
+- After each quiz completion
+- After each session artifact generation
+- On user exit from session menu
+
+### File Structure
+
+```
+teach-me-testing/
+├── workflow.md                              # Main entry point
+├── workflow.yaml                            # Workflow metadata
+│
+├── steps-c/                                 # CREATE mode (12 steps)
+│   ├── step-01-init.md
+│   ├── step-01b-continue.md
+│   ├── step-02-assess.md
+│   ├── step-03-session-menu.md
+│   ├── step-04-session-01.md
+│   ├── step-04-session-02.md
+│   ├── step-04-session-03.md
+│   ├── step-04-session-04.md
+│   ├── step-04-session-05.md
+│   ├── step-04-session-06.md
+│   ├── step-04-session-07.md
+│   └── step-05-completion.md
+│
+├── steps-e/                                 # EDIT mode (2 steps)
+│   ├── step-e-01-assess-workflow.md
+│   └── step-e-02-apply-edits.md
+│
+├── steps-v/                                 # VALIDATE mode (1 step)
+│   └── step-v-01-validate.md
+│
+├── data/                                    # Shared data files
+│   ├── curriculum.yaml
+│   ├── role-paths.yaml
+│   ├── session-content-map.yaml
+│   ├── quiz-questions.yaml
+│   └── tea-resources-index.yaml
+│
+├── templates/                               # Document templates
+│   ├── progress-template.yaml
+│   ├── session-notes-template.md
+│   └── certificate-template.md
+│
+├── instructions.md
+└── checklist.md
+```
+
+### Role and Persona Definition
+
+**AI Role:** Master Test Architect and Teaching Guide
+
+**Expertise:**
+
+- Deep knowledge of testing principles (risk-based, test pyramid, types)
+- Expert in TEA methodology (9 workflows, architecture patterns, 35 knowledge fragments)
+- Familiar with Playwright, test automation, CI/CD
+- Teaching pedagogy: progressive learning, knowledge validation, role-based examples
+
+**Communication Style:**
+
+- **Teaching:** Clear, patient, educational - adapts complexity by role
+- **Quizzes:** Encouraging, constructive feedback, non-judgmental
+- **Navigation:** Clear, concise, shows completion status prominently
+- **Tone:** Encouraging but not patronizing, technical but accessible
+
+**Teaching Principles:**
+
+1. Just-in-time learning (load content when needed)
+2. Active recall (quiz after teaching)
+3. Spaced repetition (reference earlier concepts)
+4. Role-flavored examples (same concept, different contexts)
+5. Artifact generation (learners keep notes)
+
+### Validation and Error Handling
+
+**Output Validation:**
+
+- Progress file: Schema, status, score (0-100), date, artifact paths
+- Session notes: Frontmatter present, content not empty (min 100 chars)
+- Certificate: All 7 sessions complete, valid dates, user info present
+
+**User Input Validation:**
+
+- Role: Must be QA, Dev, Lead, or VP
+- Experience: beginner, intermediate, or experienced
+- Quiz answers: 3 attempts before showing correct answer
+- Session selection: Must be 1-7 or X
+
+**Error Recovery:**
+
+- Corrupted progress: Backup, offer fresh start
+- Missing docs: Web-Browsing fallback
+- Quiz failure: Review or continue options
+- Interrupted session: Auto-save progress
+
+**Success Criteria:**
+
+- Session complete: Content presented, quiz passed, notes generated, progress updated
+- Workflow complete: All 7 sessions done, avg score ≥70%, artifacts created, certificate generated
+
+### Special Features
+
+**Conditional Logic:**
+
+- Session menu routing: Check if all complete → route to completion or show menu
+- Quiz scoring: If ≥70% proceed, if <70% offer review
+
+**Branch Points:**
+
+- Initial entry: Progress exists? → continue vs new
+- Experience-based recommendations: Beginner → session 1, Experienced → session 7
+
+**Integration with TEA Workflows:**
+
+- Session 1: Demonstrates [TA] Automate
+- Session 3: May run [TF] Framework
+- Session 4: Runs [TD] Test Design
+- Session 5: Runs [AT] ATDD + [TA] Automate
+- Session 6: Runs [RV] Test Review + [TR] Trace
+
+**Role-Based Content:**
+
+- QA: Practical testing focus
+- Dev: Integration and TDD focus
+- Lead: Architecture and patterns focus
+- VP: Strategy and metrics focus
+
+**Session 7 Special Handling:**
+
+- Exploratory menu-driven deep-dive into 35 knowledge fragments
+- Organized by categories (Testing Patterns, Playwright Utils, Config/Governance, etc.)
+- Links to GitHub for browsing
+
+**Content Sources (Triple Reference System):**
+
+- Local files: `/docs/*.md`, `/src/testarch/knowledge/*.md`
+- Online docs: `<https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/`>
+- GitHub fragments: Direct links to knowledge fragment source files
+
+### Design Summary
+
+**Complete:** 12-step CREATE workflow with hub pattern
+**Continuable:** Progress file tracks state across sessions
+**Non-linear:** Users jump to any session from hub
+**Role-flavored:** Same concepts, role-specific examples
+**Triple content:** Local + online + GitHub sources
+**Web-Browsing:** Fallback for missing/updated docs
+**Auto-save:** After each session completion
+**Tri-modal:** Create (12 steps) + Edit (2 steps) + Validate (1 step)
+
+## Foundation Build Complete
+
+**Created:** 2026-01-28
+
+**Folder Structure:**
+
+```
+teach-me-testing/
+├── workflow.md                           ✓ Created
+├── steps-c/                              ✓ Created (empty, to be populated)
+├── steps-e/                              ✓ Created (empty, to be populated)
+├── steps-v/                              ✓ Created (empty, to be populated)
+├── data/                                 ✓ Created (empty, to be populated)
+├── templates/                            ✓ Created
+│   ├── progress-template.yaml            ✓ Created
+│   ├── session-notes-template.md         ✓ Created
+│   └── certificate-template.md           ✓ Created
+├── instructions.md                       ✓ Created
+└── checklist.md                          ✓ Created
+```
+
+**Location:** {external-project-root}/\_bmad-output/bmb-creations/workflows/teach-me-testing/
+
+**Configuration:**
+
+- Workflow name: teach-me-testing
+- Continuable: Yes (multi-session learning)
+- Document output: Yes (Progress YAML, Session notes MD, Certificate MD)
+- Mode: Tri-modal (Create + Edit + Validate)
+- Module: TEA (Test Architecture Enterprise)
+
+**Files Created:**
+
+1. **workflow.md**
+   - Tri-modal routing logic (Create/Edit/Validate)
+   - Configuration loading from TEA module
+   - Step-file architecture principles
+   - Initialization sequence
+
+2. **templates/progress-template.yaml**
+   - Complete progress tracking schema
+   - 7 sessions defined
+   - Session status tracking (not-started/in-progress/completed)
+   - stepsCompleted array for continuation
+   - Progress metrics (completion_percentage, next_recommended)
+
+3. **templates/session-notes-template.md**
+   - Session metadata
+   - Key concepts, objectives, takeaways
+   - TEA resources referenced
+   - Quiz results
+   - Practical examples
+
+4. **templates/certificate-template.md**
+   - Completion certificate structure
+   - All 7 sessions with scores
+   - Skills acquired checklist
+   - Learning artifacts paths
+   - Next steps recommendations
+
+5. **instructions.md**
+   - How to run the workflow
+   - Session structure and flow
+   - Progress tracking details
+   - Troubleshooting guide
+
+6. **checklist.md**
+   - Quality validation checklist
+   - Foundation quality checks
+   - Step file quality standards
+   - Data file quality requirements
+   - Completion criteria
+
+**Next Steps:**
+
+- Step 8: Build step-01-init.md (initialization with continuation detection)
+- Step 9: Build step-01b-continue.md (continuation/resume logic)
+- Step 10+: Build remaining 10 step files (assessment, session menu, 7 sessions, completion)
+- Populate data/ folder with curriculum, role paths, session content map, quizzes, resources index
+
+## Step 01 Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+- `steps-c/step-01-init.md` ✓
+- `steps-c/step-01b-continue.md` ✓
+
+**Step Configuration:**
+
+- **Type:** Continuable (multi-session learning)
+- **Input Discovery:** No (self-contained teaching)
+- **Progress File:** `{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml`
+- **Menu Pattern:** Auto-proceed (no user menu)
+
+**step-01-init.md:**
+
+- Checks for existing progress file
+- If exists → routes to step-01b-continue
+- If not → creates new progress from template, proceeds to step-02-assess
+- Initializes stepsCompleted array
+- Creates complete session tracking structure (all 7 sessions)
+
+**step-01b-continue.md:**
+
+- Loads existing progress file
+- Updates lastContinued timestamp
+- Displays progress dashboard with completion status
+- Shows session indicators (✅ completed, 🔄 in-progress, ⬜ not-started)
+- Auto-routes to step-03-session-menu (hub)
+
+**Frontmatter Compliance:**
+
+- All variables used in step body
+- Relative paths for internal references
+- No hardcoded paths
+- Follows frontmatter standards
+
+**Next Steps:**
+
+- Build step-02-assess.md (assessment)
+- Build step-03-session-menu.md (hub)
+- Build 7 session steps (step-04-session-01 through step-04-session-07)
+- Build step-05-completion.md (certificate generation)
+
+## Step 02 Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+- `steps-c/step-02-assess.md` ✓
+
+**Step Configuration:**
+
+- **Type:** Middle Step (Standard) auto-proceed
+- **Next Step:** step-03-session-menu
+- **Menu Pattern:** Auto-proceed (Pattern 3) - no user menu
+
+**step-02-assess.md:**
+
+- Gathers role (QA/Dev/Lead/VP) with validation
+- Gathers experience level (beginner/intermediate/experienced) with validation
+- Gathers learning goals (required, validated)
+- Gathers pain points (optional)
+- Updates progress file with all assessment data
+- Provides experience-based session recommendations
+- Updates stepsCompleted array with 'step-02-assess'
+- Routes to step-03-session-menu (hub)
+
+**Frontmatter Compliance:**
+
+- All variables used in step body
+- Relative paths for internal references
+- No hardcoded paths
+- Follows frontmatter standards
+
+**Remaining Steps:** 9 more to build
+
+- step-03-session-menu (hub with branching)
+- step-04-session-01 through step-04-session-07 (7 teaching sessions)
+- step-05-completion (certificate generation)
+
+## Step 03 Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+- `steps-c/step-03-session-menu.md` ✓
+
+**Step Configuration:**
+
+- **Type:** Branch Step (Hub) with custom menu (1-7, X)
+- **Routes To:** Any of 7 sessions OR completion OR exit
+- **Menu Pattern:** Custom branching (Pattern 4)
+
+**step-03-session-menu.md:**
+
+- Loads progress file to get session completion status
+- Displays all 7 sessions with status indicators (✅ completed, 🔄 in-progress, ⬜ not-started)
+- Shows completion percentage and scores
+- Provides session descriptions and durations
+- Recommends next session based on progress
+- Detects when all 7 sessions complete → routes to completion
+- Allows non-linear session selection (jump to any session)
+- Exit option (X) saves progress and ends workflow
+- This is the HUB - all sessions return here
+- No stepsCompleted update (routing hub, not content step)
+
+**Routing Logic:**
+
+- 1-7 → Routes to corresponding session step
+- X → Saves and exits workflow
+- All complete → Auto-routes to step-05-completion
+
+**Frontmatter Compliance:**
+
+- All 7 session file references used in routing logic
+- Completion file reference used for all-done scenario
+- Progress file loaded for status display
+- Relative paths for all step files
+
+**Remaining Steps:** 8 more to build
+
+- step-04-session-01 through step-04-session-07 (7 teaching sessions)
+- step-05-completion (certificate generation)
+
+## Step 04-Session-01 Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+- `steps-c/step-04-session-01.md` ✓
+
+**Step Configuration:**
+
+- **Type:** Middle Step (Complex) with A/P/C menu
+- **Session:** Quick Start (30 min)
+- **Next Step:** Returns to step-03-session-menu (hub)
+- **Menu Pattern:** Standard A/P/C (Pattern 1)
+
+**step-04-session-01.md:**
+
+- Session 1: Quick Start - TEA Lite intro, run automate workflow
+- Updates progress (status: in-progress at start, completed at end)
+- Teaching content: What is TEA, TEA Lite, Automate workflow, engagement models
+- Role-adapted examples (QA/Dev/Lead/VP perspectives)
+- 3-question quiz with validation (passing: ≥70%)
+- Quiz retry option if failing (<70%)
+- Generates session notes using template with all quiz results
+- Updates progress file (status, score, notes_artifact, completion_percentage)
+- Updates stepsCompleted array with 'step-04-session-01'
+- Returns to session menu hub (step-03)
+
+**Teaching Topics:**
+
+- What is TEA and why it exists
+- 9 workflows + 35 knowledge fragments
+- Quality standards (Definition of Done)
+- Risk-based testing (P0-P3 matrix)
+- TEA engagement models (Lite/Solo/Integrated/Enterprise/Brownfield)
+- Automate workflow conceptual overview
+
+**TEA Resources Referenced:**
+
+- TEA Overview, TEA Lite Quickstart, Automate Workflow docs
+- Online URLs provided for further reading
+
+**Remaining Steps:** 7 more to build
+
+- step-04-session-02 through step-04-session-07 (6 more teaching sessions)
+- step-05-completion (certificate generation)
+
+## Step 04-Session-02 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-02.md` ✓
+**Session:** Core Concepts (45 min) - Testing as Engineering, Risk-based testing (P0-P3), TEA Definition of Done
+**Pattern:** Middle Step (Complex) with A/P/C menu, returns to hub
+**Teaching:** Philosophy, risk matrix, quality standards with role-adapted examples
+**Quiz:** 3 questions on P0-P3, hard waits, self-cleaning tests
+**Knowledge Fragments:** test-quality.md, probability-impact.md
+
+**Remaining:** 6 steps (sessions 03-07 + completion)
+
+## Step 04-Session-03 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-03.md` ✓
+**Session:** Architecture & Patterns (60 min)
+**Topics:** Fixture composition, network-first patterns, data factories, step-file architecture
+**Knowledge Fragments:** fixture-architecture.md, network-first.md, data-factories.md
+**Quiz:** 3 questions on fixtures, network-first, step-file architecture
+
+## Step 04-Session-04 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-04.md` ✓
+**Session:** Test Design (60 min)
+**Topics:** Test Design workflow, risk/testability assessment, coverage planning, test priorities matrix
+**Knowledge Fragments:** test-levels-framework.md, test-priorities-matrix.md
+**Quiz:** 3 questions on test design, risk calculation, P0 coverage
+
+## Step 04-Session-05 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-05.md` ✓
+**Session:** ATDD & Automate (60 min)
+**Topics:** ATDD workflow (red-green TDD), Automate workflow, component TDD, API testing patterns
+**Knowledge Fragments:** component-tdd.md, api-testing-patterns.md, api-request.md
+**Quiz:** 3 questions on TDD red phase, ATDD vs Automate, API testing
+
+## Step 04-Session-06 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-06.md` ✓
+**Session:** Quality & Trace (45 min)
+**Topics:** Test Review workflow (5 dimensions), Trace workflow, quality metrics
+**Quiz:** 3 questions on quality dimensions, release gates, metrics
+
+## Step 04-Session-07 Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-04-session-07.md` ✓
+**Session:** Advanced Patterns (ongoing)
+**Format:** Menu-driven exploration of 35 knowledge fragments
+**Categories:** Testing Patterns (9), Playwright Utils (11), Config/Governance (6), Quality Frameworks (5), Auth/Security (3)
+**No Quiz:** Exploratory session, score: 100 on completion
+**Special:** Repeatable, user can explore multiple fragments, returns to hub
+
+## Step 05-Completion Build Complete
+
+**Created:** 2026-01-28
+**Files:** `steps-c/step-05-completion.md` ✓
+**Type:** Final Step (no next step)
+**Purpose:** Verify all 7 sessions complete, generate certificate, final progress update, celebrate
+**Certificate:** Includes all session scores, skills acquired, learning artifacts, next steps
+**Final:** Updates progress (certificate_generated: true, completion_date)
+**No Menu:** Workflow ends here
+
+---
+
+## CREATE Mode Build Complete (12 Steps)
+
+**All CREATE mode steps built:** ✓
+
+1. step-01-init.md - Initialize with continuation detection
+2. step-01b-continue.md - Resume with progress dashboard
+3. step-02-assess.md - Role/experience assessment
+4. step-03-session-menu.md - Session selection hub
+5. step-04-session-01.md - Quick Start
+6. step-04-session-02.md - Core Concepts
+7. step-04-session-03.md - Architecture & Patterns
+8. step-04-session-04.md - Test Design
+9. step-04-session-05.md - ATDD & Automate
+10. step-04-session-06.md - Quality & Trace
+11. step-04-session-07.md - Advanced Patterns
+12. step-05-completion.md - Certificate generation
+
+**Remaining:**
+
+- Data files (curriculum.yaml, role-paths.yaml, session-content-map.yaml, quiz-questions.yaml, tea-resources-index.yaml)
+- EDIT mode steps (2 steps)
+- VALIDATE mode steps (1 step)
+
+---
+
+## Data Files Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+1. `data/curriculum.yaml` ✓ - 7-session structure, learning paths by experience, completion requirements
+2. `data/role-paths.yaml` ✓ - Role customizations for QA/Dev/Lead/VP with focus areas and teaching adaptations
+3. `data/session-content-map.yaml` ✓ - Maps sessions to TEA docs, knowledge fragments, online URLs, workflows
+4. `data/quiz-questions.yaml` ✓ - Question bank for sessions 1-6 (session 7 is exploratory, no quiz)
+5. `data/tea-resources-index.yaml` ✓ - Comprehensive index of 32 docs + 35 knowledge fragments with GitHub links
+
+**All 5 data files complete.**
+
+---
+
+## EDIT Mode Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+1. `steps-e/step-e-01-assess-workflow.md` ✓ - Identify what to edit, gather edit requirements
+2. `steps-e/step-e-02-apply-edits.md` ✓ - Apply modifications with user approval, validate integrity
+
+**All 2 EDIT mode steps complete.**
+
+---
+
+## VALIDATE Mode Build Complete
+
+**Created:** 2026-01-28
+
+**Files:**
+
+1. `steps-v/step-v-01-validate.md` ✓ - Comprehensive quality validation against BMAD standards, generates validation report
+
+**All 1 VALIDATE mode step complete.**
+
+---
+
+## 🏆 WORKFLOW BUILD COMPLETE
+
+**Status:** ✅ 100% COMPLETE
+
+**Total Files Created:** 24 files
+
+### Foundation (6 files)
+
+- workflow.md
+- instructions.md
+- checklist.md
+- workflow-plan-teach-me-testing.md
+- (plus 3 templates)
+
+### Templates (3 files)
+
+- progress-template.yaml
+- session-notes-template.md
+- certificate-template.md
+
+### CREATE Mode (12 step files)
+
+- step-01-init.md
+- step-01b-continue.md
+- step-02-assess.md
+- step-03-session-menu.md
+- step-04-session-01.md through step-04-session-07.md (7 sessions)
+- step-05-completion.md
+
+### Data Files (5 files)
+
+- curriculum.yaml
+- role-paths.yaml
+- session-content-map.yaml
+- quiz-questions.yaml
+- tea-resources-index.yaml
+
+### EDIT Mode (2 step files)
+
+- step-e-01-assess-workflow.md
+- step-e-02-apply-edits.md
+
+### VALIDATE Mode (1 step file)
+
+- step-v-01-validate.md
+
+---
+
+## Next Action Required
+
+**DEPLOYMENT:** Move workflow from staging to TEA module
+
+**Source (Staging):**
+`{external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing/`
+
+**Target (Production):**
+`{project-root}/src/workflows/testarch/bmad-teach-me-testing/`
+
+**Command:**
+
+```bash
+cp -r {external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing \
+      {project-root}/src/workflows/testarch/
+```
+
+**After deployment:**
+
+1. Update TEA agent menu to add [TMT] Teach Me Testing
+2. Test the workflow: `bmad run teach-me-testing`
+3. Validate: `bmad run teach-me-testing -v`
+4. Document in TEA module README
+
+---
+
+**Workflow Creation: COMPLETE** ✅
+**Ready for Deployment:** YES
+**Validation Status:** Not yet validated (run -v mode after deployment)