bmad-studio 0.1.0 → 0.2.0

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

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

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