Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.

step-04-session-07.md 6.9KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220
  1. ---
  2. name: 'step-04-session-07'
  3. description: 'Session 7: Advanced Patterns - Menu-driven knowledge fragment exploration (ongoing)'
  4. progressFile: '{test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml'
  5. sessionNotesTemplate: '../templates/session-notes-template.md'
  6. sessionNotesFile: '{test_artifacts}/tea-academy/{user_name}/session-07-notes.md'
  7. nextStepFile: '{skill-root}/steps-c/step-03-session-menu.md'
  8. advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
  9. partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
  10. ---
  11. # Step 4: Session 7 - Advanced Patterns
  12. ## STEP GOAL:
  13. To provide menu-driven exploration of 42 TEA knowledge fragments organized by category, allowing deep-dive into specific advanced topics on-demand.
  14. ## MANDATORY EXECUTION RULES (READ FIRST):
  15. ### Universal Rules:
  16. - 🛑 NEVER generate content without user input
  17. - 📖 CRITICAL: Read complete step file before action
  18. - ✅ SPEAK OUTPUT In {communication_language}
  19. ### Role Reinforcement:
  20. - ✅ Master Test Architect and Teaching Guide
  21. - ✅ Collaborative exploration
  22. ### Step-Specific Rules:
  23. - 🎯 Focus on Session 7 (Advanced Patterns exploration)
  24. - 💬 Menu-driven, user chooses topics
  25. - 📚 This session is ONGOING - users can explore multiple fragments
  26. ## EXECUTION PROTOCOLS:
  27. - 🎯 Display fragment categories
  28. - 💾 Generate notes after exploration
  29. - 📖 Update progress when user exits
  30. - ⏭️ Return to hub when done
  31. ## MANDATORY SEQUENCE
  32. ### 1. Welcome
  33. "🧪 **Session 7: Advanced Patterns** (Ongoing Exploration)
  34. **Objective:** Deep-dive into 42 TEA knowledge fragments
  35. **This session is different:**
  36. - Menu-driven exploration (you choose topics)
  37. - Explore as many fragments as you want
  38. - Can revisit this session anytime
  39. - No quiz - this is reference learning
  40. **42 Knowledge Fragments organized by category:**
  41. Let's explore!"
  42. ### 2. Update Progress (Started)
  43. Set session-07-advanced `status: 'in-progress'` (only first time).
  44. ### 3. Display Knowledge Fragment Categories
  45. "### 📚 Knowledge Fragment Categories
  46. **1. Testing Patterns (9 fragments)**
  47. - fixture-architecture.md - Composable fixture patterns
  48. - fixtures-composition.md - mergeTests composition patterns
  49. - network-first.md - Network interception safeguards
  50. - data-factories.md - Data seeding & setup
  51. - component-tdd.md - TDD red-green loop
  52. - api-testing-patterns.md - Pure API testing
  53. - test-healing-patterns.md - Auto-fix common failures
  54. - selector-resilience.md - Robust selectors
  55. - timing-debugging.md - Race condition fixes
  56. **2. Playwright Utils (19 fragments)**
  57. - overview.md - Playwright Utils overview
  58. - api-request.md - Typed HTTP client
  59. - network-recorder.md - HAR record/playback
  60. - intercept-network-call.md - Network spy/stub
  61. - recurse.md - Async polling
  62. - log.md - Report logging
  63. - file-utils.md - CSV/XLSX/PDF validation
  64. - burn-in.md - Smart test selection
  65. - network-error-monitor.md - HTTP error detection
  66. - contract-testing.md - Pact integration
  67. - pactjs-utils-overview.md - Pact.js Utils overview
  68. - pactjs-utils-consumer-helpers.md - Consumer-side Pact helpers
  69. - pactjs-utils-provider-verifier.md - Provider verification
  70. - pactjs-utils-request-filter.md - Auth injection request filter
  71. - pact-mcp.md - SmartBear MCP for PactFlow
  72. - pact-consumer-framework-setup.md - Consumer CDC framework setup
  73. - pact-consumer-di.md - DI pattern for Pact consumers
  74. - playwright-cli.md - CLI for AI browser automation
  75. - visual-debugging.md - Trace viewer workflows
  76. **3. Configuration & Governance (6 fragments)**
  77. - playwright-config.md - Environment & timeout guardrails
  78. - ci-burn-in.md - CI orchestration
  79. - selective-testing.md - Tag/grep filters
  80. - feature-flags.md - Governance & cleanup
  81. - risk-governance.md - Scoring matrix & gates
  82. - adr-quality-readiness-checklist.md - Quality readiness checklist
  83. **4. Quality Frameworks (5 fragments)**
  84. - test-quality.md - DoD execution limits
  85. - test-levels-framework.md - Unit/Integration/E2E
  86. - test-priorities-matrix.md - P0-P3 coverage targets
  87. - probability-impact.md - Probability × impact scoring
  88. - nfr-criteria.md - NFR evidence audit definitions
  89. **5. Authentication & Security (3 fragments)**
  90. - email-auth.md - Magic link extraction
  91. - auth-session.md - Token persistence
  92. - error-handling.md - Exception handling
  93. **GitHub Repository:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>
  94. **Select a category (1-5) or specific fragment to explore, or [X] to finish:**"
  95. ### 4. Fragment Exploration Loop
  96. **Wait for user selection.**
  97. **Handle selection:**
  98. - **IF 1-5 (category):** Display all fragments in that category with descriptions, ask which fragment to explore
  99. - **IF specific fragment name:** Load and present that fragment's content
  100. - **IF X:** Proceed to step 5 (complete session)
  101. - **IF Any other:** Help user, redisplay categories
  102. **For each fragment explored:**
  103. 1. Present the fragment's key concepts
  104. 2. Provide role-adapted examples
  105. 3. Link to GitHub source
  106. 4. Ask: "Explore another fragment? [Y/N/X to finish]"
  107. 5. If Y: Redisplay categories
  108. 6. If N or X: Proceed to completion
  109. **Track fragments explored** (for session notes).
  110. ### 5. Session Summary
  111. After user selects X (finish exploration):
  112. "### 🎯 Session 7 Summary
  113. **Fragments Explored:** {count}
  114. {List each fragment explored}
  115. **Key Takeaways:**
  116. {Summarize insights from explored fragments}
  117. **Remember:** You can return to Session 7 anytime to explore more fragments!
  118. **GitHub Knowledge Base:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>"
  119. ### 6. Generate Session Notes
  120. Create {sessionNotesFile} with:
  121. - Session 7 content
  122. - List of fragments explored
  123. - Key insights from each
  124. - GitHub links
  125. - No quiz (exploratory session)
  126. - Score: 100 (completion based, not quiz based)
  127. ### 7. Update Progress (Completed)
  128. Update session-07-advanced: completed, score: 100, notes.
  129. Increment sessions_completed, update percentage.
  130. Append 'step-04-session-07' to stepsCompleted.
  131. **Check completion:**
  132. - If sessions_completed == 7: Set next_recommended: 'completion'
  133. - Otherwise: Recommend next incomplete session
  134. ### 8. Complete Message
  135. "🎉 **Session 7 Complete!**
  136. **Fragments Explored:** {count}
  137. {If sessions_completed == 7:}
  138. 🏆 **Congratulations!** You've completed ALL 7 sessions!
  139. Your completion certificate will be generated when you return to the menu.
  140. {Otherwise:}
  141. **Progress:** {completion_percentage}% complete ({sessions_completed} of 7 sessions)
  142. You can return to Session 7 anytime to explore more fragments!"
  143. ### 9. Menu
  144. [A] Advanced Elicitation [P] Party Mode [C] Continue to Session Menu
  145. Return to {nextStepFile}.
  146. ---
  147. ## 🚨 SUCCESS METRICS
  148. ✅ Fragment categories displayed, user explored chosen fragments, notes generated with exploration summary, progress updated, returned to hub.
  149. **Master Rule:** This session is exploratory and repeatable. User drives exploration, workflow facilitates.