|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220 |
- ---
- name: 'step-04-session-07'
- description: 'Session 7: Advanced Patterns - Menu-driven knowledge fragment exploration (ongoing)'
-
- progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
- sessionNotesTemplate: '../templates/session-notes-template.md'
- sessionNotesFile: '{test_artifacts}/tea-academy/{user_name}/session-07-notes.md'
- nextStepFile: '{skill-root}/steps-c/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 7 - Advanced Patterns
-
- ## STEP GOAL:
-
- To provide menu-driven exploration of 42 TEA knowledge fragments organized by category, allowing deep-dive into specific advanced topics on-demand.
-
- ## MANDATORY EXECUTION RULES (READ FIRST):
-
- ### Universal Rules:
-
- - 🛑 NEVER generate content without user input
- - 📖 CRITICAL: Read complete step file before action
- - ✅ SPEAK OUTPUT In {communication_language}
-
- ### Role Reinforcement:
-
- - ✅ Master Test Architect and Teaching Guide
- - ✅ Collaborative exploration
-
- ### Step-Specific Rules:
-
- - 🎯 Focus on Session 7 (Advanced Patterns exploration)
- - 💬 Menu-driven, user chooses topics
- - 📚 This session is ONGOING - users can explore multiple fragments
-
- ## EXECUTION PROTOCOLS:
-
- - 🎯 Display fragment categories
- - 💾 Generate notes after exploration
- - 📖 Update progress when user exits
- - ⏭️ Return to hub when done
-
- ## MANDATORY SEQUENCE
-
- ### 1. Welcome
-
- "🧪 **Session 7: Advanced Patterns** (Ongoing Exploration)
-
- **Objective:** Deep-dive into 42 TEA knowledge fragments
-
- **This session is different:**
-
- - Menu-driven exploration (you choose topics)
- - Explore as many fragments as you want
- - Can revisit this session anytime
- - No quiz - this is reference learning
-
- **42 Knowledge Fragments organized by category:**
-
- Let's explore!"
-
- ### 2. Update Progress (Started)
-
- Set session-07-advanced `status: 'in-progress'` (only first time).
-
- ### 3. Display Knowledge Fragment Categories
-
- "### 📚 Knowledge Fragment Categories
-
- **1. Testing Patterns (9 fragments)**
-
- - fixture-architecture.md - Composable fixture patterns
- - fixtures-composition.md - mergeTests composition patterns
- - network-first.md - Network interception safeguards
- - data-factories.md - Data seeding & setup
- - component-tdd.md - TDD red-green loop
- - api-testing-patterns.md - Pure API testing
- - test-healing-patterns.md - Auto-fix common failures
- - selector-resilience.md - Robust selectors
- - timing-debugging.md - Race condition fixes
-
- **2. Playwright Utils (19 fragments)**
-
- - overview.md - Playwright Utils overview
- - api-request.md - Typed HTTP client
- - network-recorder.md - HAR record/playback
- - intercept-network-call.md - Network spy/stub
- - recurse.md - Async polling
- - log.md - Report logging
- - file-utils.md - CSV/XLSX/PDF validation
- - burn-in.md - Smart test selection
- - network-error-monitor.md - HTTP error detection
- - contract-testing.md - Pact integration
- - pactjs-utils-overview.md - Pact.js Utils overview
- - pactjs-utils-consumer-helpers.md - Consumer-side Pact helpers
- - pactjs-utils-provider-verifier.md - Provider verification
- - pactjs-utils-request-filter.md - Auth injection request filter
- - pact-mcp.md - SmartBear MCP for PactFlow
- - pact-consumer-framework-setup.md - Consumer CDC framework setup
- - pact-consumer-di.md - DI pattern for Pact consumers
- - playwright-cli.md - CLI for AI browser automation
- - visual-debugging.md - Trace viewer workflows
-
- **3. Configuration & Governance (6 fragments)**
-
- - playwright-config.md - Environment & timeout guardrails
- - ci-burn-in.md - CI orchestration
- - selective-testing.md - Tag/grep filters
- - feature-flags.md - Governance & cleanup
- - risk-governance.md - Scoring matrix & gates
- - adr-quality-readiness-checklist.md - Quality readiness checklist
-
- **4. Quality Frameworks (5 fragments)**
-
- - test-quality.md - DoD execution limits
- - test-levels-framework.md - Unit/Integration/E2E
- - test-priorities-matrix.md - P0-P3 coverage targets
- - probability-impact.md - Probability × impact scoring
- - nfr-criteria.md - NFR evidence audit definitions
-
- **5. Authentication & Security (3 fragments)**
-
- - email-auth.md - Magic link extraction
- - auth-session.md - Token persistence
- - error-handling.md - Exception handling
-
- **GitHub Repository:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>
-
- **Select a category (1-5) or specific fragment to explore, or [X] to finish:**"
-
- ### 4. Fragment Exploration Loop
-
- **Wait for user selection.**
-
- **Handle selection:**
-
- - **IF 1-5 (category):** Display all fragments in that category with descriptions, ask which fragment to explore
- - **IF specific fragment name:** Load and present that fragment's content
- - **IF X:** Proceed to step 5 (complete session)
- - **IF Any other:** Help user, redisplay categories
-
- **For each fragment explored:**
-
- 1. Present the fragment's key concepts
- 2. Provide role-adapted examples
- 3. Link to GitHub source
- 4. Ask: "Explore another fragment? [Y/N/X to finish]"
- 5. If Y: Redisplay categories
- 6. If N or X: Proceed to completion
-
- **Track fragments explored** (for session notes).
-
- ### 5. Session Summary
-
- After user selects X (finish exploration):
-
- "### 🎯 Session 7 Summary
-
- **Fragments Explored:** {count}
-
- {List each fragment explored}
-
- **Key Takeaways:**
- {Summarize insights from explored fragments}
-
- **Remember:** You can return to Session 7 anytime to explore more fragments!
-
- **GitHub Knowledge Base:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>"
-
- ### 6. Generate Session Notes
-
- Create {sessionNotesFile} with:
-
- - Session 7 content
- - List of fragments explored
- - Key insights from each
- - GitHub links
- - No quiz (exploratory session)
- - Score: 100 (completion based, not quiz based)
-
- ### 7. Update Progress (Completed)
-
- Update session-07-advanced: completed, score: 100, notes.
- Increment sessions_completed, update percentage.
- Append 'step-04-session-07' to stepsCompleted.
-
- **Check completion:**
-
- - If sessions_completed == 7: Set next_recommended: 'completion'
- - Otherwise: Recommend next incomplete session
-
- ### 8. Complete Message
-
- "🎉 **Session 7 Complete!**
-
- **Fragments Explored:** {count}
-
- {If sessions_completed == 7:}
- 🏆 **Congratulations!** You've completed ALL 7 sessions!
- Your completion certificate will be generated when you return to the menu.
-
- {Otherwise:}
- **Progress:** {completion_percentage}% complete ({sessions_completed} of 7 sessions)
- You can return to Session 7 anytime to explore more fragments!"
-
- ### 9. Menu
-
- [A] Advanced Elicitation [P] Party Mode [C] Continue to Session Menu
-
- Return to {nextStepFile}.
-
- ---
-
- ## 🚨 SUCCESS METRICS
-
- ✅ Fragment categories displayed, user explored chosen fragments, notes generated with exploration summary, progress updated, returned to hub.
-
- **Master Rule:** This session is exploratory and repeatable. User drives exploration, workflow facilitates.
|