bmad-studio 0.1.0

package/_bmad/tea/workflows/testarch/bmad-teach-me-testing/steps-c/step-04-session-03.md

@@ -0,0 +1,301 @@
+---
+name: 'step-04-session-03'
+description: 'Session 3: Architecture & Patterns - Fixtures, network patterns, framework setup (60 min)'
+
+progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
+sessionNotesTemplate: '../templates/session-notes-template.md'
+sessionNotesFile: '{test_artifacts}/tea-academy/{user_name}/session-03-notes.md'
+nextStepFile: './step-03-session-menu.md'
+advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 4: Session 3 - Architecture & Patterns
+
+## STEP GOAL:
+
+To teach TEA architecture patterns including fixture composition, network-first patterns, and step-file architecture in a 60-minute session.
+
+## 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
+
+### Step-Specific Rules:
+
+- 🎯 Focus ONLY on Session 3 content (Architecture & Patterns)
+- 🚫 FORBIDDEN to skip ahead to other sessions
+- 💬 Approach: Teach patterns, provide examples, quiz understanding
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load TEA docs just-in-time
+- 💾 Generate session notes after completion
+- 📖 Update progress file with session completion and score
+- ⏭️ Return to session menu hub after completion
+
+## CONTEXT BOUNDARIES:
+
+- Available context: Progress file with user role/experience
+- Focus: Session 3 - Architecture patterns
+- Dependencies: Progress file exists
+
+## MANDATORY SEQUENCE
+
+**CRITICAL:** Follow this sequence exactly.
+
+### 1. Session Welcome
+
+"🧪 **Session 3: Architecture & Patterns** (60 minutes)
+
+**Objective:** Understand TEA patterns and architecture
+
+**What you'll learn:**
+
+- Fixture architecture and composition
+- Network-first patterns
+- Data factories and test setup
+- Step-file architecture (the pattern this workflow uses!)
+
+Let's explore TEA architecture!"
+
+### 2. Update Progress (Started)
+
+Load {progressFile}, update session-03-architecture:
+
+- `status: 'in-progress'`
+- `started_date: {current_date}`
+
+### 3. Teaching: Fixture Architecture
+
+"### 🏗️ Fixture Architecture
+
+**The Problem:** Tests have setup/teardown boilerplate everywhere.
+
+**TEA Solution:** Composable fixtures
+
+**Fixture Composition Pattern:**
+
+```typescript
+// Base fixtures
+const baseFixtures = {
+  page: async ({}, use) => {
+    /* ... */
+  },
+};
+
+// Composed fixtures
+const authFixtures = {
+  authenticatedPage: async ({ page }, use) => {
+    await page.goto('/login');
+    await login(page);
+    await use(page);
+  },
+};
+
+// Merge and use
+test.use(mergeTests(baseFixtures, authFixtures));
+```
+
+**Benefits:**
+
+- DRY: Define once, use everywhere
+- Composable: Build complex fixtures from simple ones
+- Automatic cleanup: Fixtures handle teardown
+- Type-safe: Full TypeScript support
+
+{Role-adapted example based on user role}
+
+**Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/fixture-architecture/>
+**Knowledge Fragment:** fixture-architecture.md, fixtures-composition.md"
+
+### 4. Teaching: Network-First Patterns
+
+"### 🌐 Network-First Patterns
+
+**The Problem:** Flaky tests due to network timing issues.
+
+**TEA Solution:** Intercept and control network
+
+**Network-First Pattern:**
+
+```typescript
+// BEFORE the action, set up network interception
+await page.route('/api/users', (route) => {
+  route.fulfill({ json: mockUsers });
+});
+
+// THEN trigger the action
+await page.click('Load Users');
+
+// Network is already mocked - no race condition
+```
+
+**Why Network-First:**
+
+- Prevents race conditions
+- Deterministic test behavior
+- Fast (no real API calls)
+- Control error scenarios
+
+{Role-adapted example}
+
+**Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/network-first-patterns/>
+**Knowledge Fragment:** network-first.md, intercept-network-call.md"
+
+### 5. Teaching: Data Factories
+
+"### 🏭 Data Factories
+
+**The Problem:** Hard-coded test data everywhere.
+
+**TEA Solution:** Factory functions
+
+**Factory Pattern:**
+
+```typescript
+function createUser(overrides = {}) {
+  return {
+    id: faker.uuid(),
+    email: faker.email(),
+    role: 'user',
+    ...overrides,
+  };
+}
+
+// Use in tests
+const admin = createUser({ role: 'admin' });
+const user = createUser(); // defaults
+```
+
+**Benefits:**
+
+- No hardcoded data
+- Easy to override fields
+- Consistent test data
+- Self-documenting
+
+{Role-adapted example}
+
+**Knowledge Fragment:** data-factories.md"
+
+### 6. Teaching: Step-File Architecture
+
+"### 📋 Step-File Architecture
+
+**This workflow uses step-file architecture!**
+
+**Pattern:**
+
+- Micro-file design: Each step is self-contained
+- Just-in-time loading: Only current step in memory
+- Sequential enforcement: No skipping steps
+- State tracking: Progress saved between steps
+
+**Why:**
+
+- Disciplined execution
+- Clear progression
+- Resumable (continuable workflows)
+- Maintainable (one file per step)
+
+**You're experiencing this right now:** Each session is a step file!
+
+**Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/step-file-architecture/>"
+
+### 7. Quiz (3 questions)
+
+"### ✅ Knowledge Check"
+
+**Q1:** "What is the main benefit of fixture composition?
+A) Faster test execution
+B) DRY - define once, reuse everywhere
+C) Better error messages
+D) Automatic screenshot capture"
+
+Correct: B
+
+**Q2:** "Why is 'network-first' better than mocking after the action?
+A) It's faster
+B) It prevents race conditions
+C) It uses less memory
+D) It's easier to write"
+
+Correct: B
+
+**Q3:** "What pattern does this teaching workflow use?
+A) Page Object Model
+B) Behavior Driven Development
+C) Step-File Architecture
+D) Test Pyramid"
+
+Correct: C
+
+Calculate score, handle <70% retry option.
+
+### 8. Generate Session Notes
+
+Create {sessionNotesFile} with:
+
+- Session 3 content
+- Topics: Fixtures, network-first, data factories, step-file architecture
+- TEA docs referenced
+- Knowledge fragments: fixture-architecture.md, network-first.md, data-factories.md
+- Quiz results
+- Next recommended: session-04-test-design
+
+### 9. Update Progress (Completed)
+
+Update session-03-architecture:
+
+- `status: 'completed'`
+- `completed_date: {current_date}`
+- `score: {score}`
+- `notes_artifact`
+
+Increment sessions_completed, update completion_percentage.
+Append 'step-04-session-03' to stepsCompleted.
+
+### 10. Complete Message
+
+"🎉 **Session 3 Complete!** Score: {score}/100
+You understand TEA architecture patterns!
+Progress: {completion_percentage}%"
+
+### 11. Menu
+
+[A] Advanced Elicitation [P] Party Mode [C] Continue to Session Menu
+
+Return to {nextStepFile}
+
+---
+
+## 🚨 SYSTEM SUCCESS/FAILURE METRICS
+
+### ✅ SUCCESS:
+
+- Architecture patterns taught
+- Quiz administered
+- Notes generated
+- Progress updated
+- Returned to hub
+
+### ❌ SYSTEM FAILURE:
+
+- Skipping patterns
+- Not generating notes
+- Not updating progress
+
+**Master Rule:** Teach patterns, quiz, update, return to hub.

package/_bmad/tea/workflows/testarch/bmad-teach-me-testing/steps-c/step-04-session-04.md

@@ -0,0 +1,234 @@
+---
+name: 'step-04-session-04'
+description: 'Session 4: Test Design - Risk assessment, test design workflow (60 min)'
+
+progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
+sessionNotesTemplate: '../templates/session-notes-template.md'
+sessionNotesFile: '{test_artifacts}/tea-academy/{user_name}/session-04-notes.md'
+nextStepFile: './step-03-session-menu.md'
+advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+---
+
+# Step 4: Session 4 - Test Design
+
+## STEP GOAL:
+
+To teach risk assessment and coverage planning using the TEA Test Design workflow in a 60-minute session.
+
+## 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
+- ✅ You bring expertise in TEA methodology
+
+### Step-Specific Rules:
+
+- 🎯 Focus on Session 4 (Test Design)
+- 💬 Teach workflow, provide examples
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Load docs just-in-time
+- 💾 Generate notes
+- 📖 Update progress
+- ⏭️ Return to hub
+
+## MANDATORY SEQUENCE
+
+### 1. Welcome
+
+"🧪 **Session 4: Test Design** (60 minutes)
+
+**Objective:** Learn risk assessment and coverage planning
+
+**What you'll learn:**
+
+- Test Design workflow
+- Risk/testability assessment
+- Coverage planning with test levels
+- Test priorities matrix
+
+Let's plan some tests!"
+
+### 2. Update Progress (Started)
+
+Set session-04-test-design `status: 'in-progress'`, `started_date`.
+
+### 3. Teaching: Test Design Workflow
+
+"### 📐 Test Design Workflow
+
+**Purpose:** Plan tests BEFORE writing them (design before code).
+
+**Workflow Steps:**
+
+1. **Load Context:** Understand feature/system
+2. **Risk/Testability Assessment:** Score probability × impact
+3. **Coverage Planning:** Determine what to test and how
+4. **Generate Test Design Document:** Blueprint for implementation
+
+**When to Use:**
+
+- New features (epic/system level)
+- Major refactors
+- Quality gate before development
+
+{Role-adapted example}
+
+**Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/>"
+
+### 4. Teaching: Risk/Testability Assessment
+
+"### ⚖️ Risk & Testability Assessment
+
+**Risk Scoring:**
+
+- **Probability:** How likely is this to fail? (Low/Medium/High)
+- **Impact:** What happens if it fails? (Low/Medium/High)
+- **Risk = Probability × Impact**
+
+**Example: Login Feature**
+
+- Probability: High (complex, authentication)
+- Impact: High (business critical)
+- **Risk: HIGH** → P0 priority
+
+**Example: Tooltip Text**
+
+- Probability: Low (simple rendering)
+- Impact: Low (aesthetic only)
+- **Risk: LOW** → P3 priority
+
+**Testability:**
+
+- Can we test this easily?
+- Are there dependencies blocking us?
+- Do we need test infrastructure first?
+
+{Role-adapted example}
+
+**Knowledge Fragments:** probability-impact.md, test-priorities-matrix.md"
+
+### 5. Teaching: Coverage Planning
+
+"### 📋 Coverage Planning
+
+**Test Levels Framework:**
+
+**Unit Tests:** Isolated functions/classes
+
+- Fast, focused
+- No external dependencies
+- Example: Pure functions, business logic
+
+**Integration Tests:** Multiple components together
+
+- Database, API interactions
+- Example: Service layer with DB
+
+**E2E Tests:** Full user workflows
+
+- Browser automation
+- Example: Complete checkout flow
+
+**Coverage Strategy:**
+
+- **P0 features:** Unit + Integration + E2E (high confidence)
+- **P1 features:** Integration + E2E (good coverage)
+- **P2 features:** E2E or Integration (basic coverage)
+- **P3 features:** Manual or skip (low priority)
+
+{Role-adapted example}
+
+**Knowledge Fragment:** test-levels-framework.md
+
+**Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/test-quality-standards/>"
+
+### 6. Teaching: Test Priorities Matrix
+
+"### 📊 Test Priorities Matrix
+
+**P0-P3 Coverage Targets:**
+
+| Priority | Unit | Integration | E2E | Manual |
+| -------- | ---- | ----------- | --- | ------ |
+| P0       | ✅   | ✅          | ✅  | ✅     |
+| P1       | ✅   | ✅          | ✅  | -      |
+| P2       | -    | ✅          | -   | ✅     |
+| P3       | -    | -           | -   | ✅     |
+
+**Goal:** 100% P0, 80% P1, 50% P2, 20% P3
+
+{Role-adapted example}
+
+**Knowledge Fragment:** test-priorities-matrix.md"
+
+### 7. Quiz (3 questions)
+
+**Q1:** "What does the Test Design workflow help you do?
+A) Write tests faster
+B) Plan tests BEFORE writing them
+C) Run tests in parallel
+D) Debug test failures"
+
+Correct: B
+
+**Q2:** "How do you calculate risk?
+A) Probability + Impact
+B) Probability × Impact
+C) Probability - Impact
+D) Probability / Impact"
+
+Correct: B
+
+**Q3:** "For P0 features, which test levels should you use?
+A) Only E2E tests
+B) Only unit tests
+C) Unit + Integration + E2E (comprehensive)
+D) Manual testing only"
+
+Correct: C
+
+Calculate score, handle <70% retry.
+
+### 8. Generate Session Notes
+
+Create {sessionNotesFile} with Session 4 content, docs, fragments, quiz.
+
+### 9. Update Progress (Completed)
+
+Update session-04-test-design: completed, score, notes.
+Increment sessions_completed, update percentage.
+Append 'step-04-session-04' to stepsCompleted.
+Set next_recommended: 'session-05-atdd-automate'.
+
+### 10. Complete Message
+
+"🎉 **Session 4 Complete!** Score: {score}/100
+You can now plan tests using risk assessment!
+Progress: {completion_percentage}%"
+
+### 11. Menu
+
+[A] Advanced Elicitation [P] Party Mode [C] Continue to Session Menu
+
+Return to {nextStepFile}.
+
+---
+
+## 🚨 SUCCESS METRICS
+
+✅ Test Design workflow taught, quiz passed, notes generated, progress updated, returned to hub.
+
+**Master Rule:** Teach planning, quiz, update, return.