initial commit

2026-03-16 19:54:53 -04:00
commit bfe0e01254
3341 changed files with 483939 additions and 0 deletions
--- a/.gemini/skills/bmad-teach-me-testing/data/curriculum.yaml
+++ b/.gemini/skills/bmad-teach-me-testing/data/curriculum.yaml
@@ -0,0 +1,129 @@
+# TEA Academy Curriculum Structure
+# Defines the 7-session learning path with objectives and content mappings
+
+sessions:
+  - id: session-01-quickstart
+    name: "Quick Start"
+    duration: "30 min"
+    difficulty: beginner
+    objective: "Get immediate value by seeing TEA in action"
+    description: "TEA Lite intro, run automate workflow, understand engagement models"
+    recommended_for:
+      - beginner
+      - intermediate
+      - experienced
+    prerequisites: []
+
+  - id: session-02-concepts
+    name: "Core Concepts"
+    duration: "45 min"
+    difficulty: beginner
+    objective: "Understand WHY behind TEA principles"
+    description: "Risk-based testing, DoD, testing as engineering philosophy"
+    recommended_for:
+      - beginner
+      - intermediate
+    prerequisites: []
+
+  - id: session-03-architecture
+    name: "Architecture & Patterns"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Understand TEA patterns and architecture"
+    description: "Fixtures, network-first patterns, data factories, step-file architecture"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-04-test-design
+    name: "Test Design"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Learn risk assessment and coverage planning"
+    description: "Test Design workflow, risk/testability assessment, coverage planning"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-05-atdd-automate
+    name: "ATDD & Automate"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Generate tests with TDD red-green approach"
+    description: "ATDD workflow (red phase), Automate workflow, component TDD, API testing"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-06-quality-trace
+    name: "Quality & Trace"
+    duration: "45 min"
+    difficulty: intermediate
+    objective: "Audit quality and ensure traceability"
+    description: "Test Review (5 dimensions), Trace workflow, quality metrics"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-07-advanced
+    name: "Advanced Patterns"
+    duration: "ongoing"
+    difficulty: advanced
+    objective: "Deep-dive into specific knowledge fragments"
+    description: "Menu-driven exploration of 35 knowledge fragments organized by category"
+    recommended_for:
+      - experienced
+    prerequisites: []
+
+# Learning Paths by Experience Level
+learning_paths:
+  beginner:
+    recommended_sequence:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional: []
+
+  intermediate:
+    recommended_sequence:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional:
+      - session-01-quickstart # Can skip if already familiar
+    certificate_eligible_if_skipped: false
+
+  experienced:
+    recommended_sequence:
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional:
+      - session-01-quickstart
+    certificate_eligible_if_skipped: false
+
+# Completion Requirements
+completion:
+  minimum_sessions: 7 # All sessions required for certificate
+  passing_score: 70 # Minimum quiz score to pass session
+  average_score_threshold: 70 # Minimum average for certificate
+  certificate_note: "Certificate eligibility requires completion.minimum_sessions. If intermediate.skip_optional or experienced.skip_optional sessions are skipped, certificate eligibility is forfeited."
--- a/.gemini/skills/bmad-teach-me-testing/data/quiz-questions.yaml
+++ b/.gemini/skills/bmad-teach-me-testing/data/quiz-questions.yaml
@@ -0,0 +1,206 @@
+# Quiz Questions Bank
+# Organized by session with questions, answers, and explanations
+
+session-01-quickstart:
+  passing_score: 70
+  questions:
+    - id: q1-purpose
+      question: "What is the primary purpose of TEA?"
+      options:
+        A: "Replace all testing tools with a single framework"
+        B: "Make testing expertise accessible through structured workflows and knowledge"
+        C: "Automate 100% of test writing"
+        D: "Only works for Playwright tests"
+      correct: B
+      explanation: "TEA makes testing expertise accessible and scalable through workflows and knowledge fragments. It's not about replacing tools or automating everything."
+
+    - id: q2-risk-matrix
+      question: "What does the P0-P3 risk matrix help with?"
+      options:
+        A: "Prioritizing test coverage based on criticality"
+        B: "Grading test code quality"
+        C: "Measuring test execution speed"
+        D: "Tracking bug severity"
+      correct: A
+      explanation: "P0-P3 helps prioritize what to test based on risk (Probability × Impact). P0 = critical features like login, P3 = nice-to-have like tooltips."
+
+    - id: q3-engagement
+      question: "Which TEA engagement model is best for quick value in 30 minutes?"
+      options:
+        A: "TEA Enterprise"
+        B: "TEA Lite"
+        C: "TEA Integrated"
+        D: "TEA Brownfield"
+      correct: B
+      explanation: "TEA Lite is the 30-minute quick start approach. Enterprise and Integrated are more comprehensive."
+
+session-02-concepts:
+  passing_score: 70
+  questions:
+    - id: q1-p0-priority
+      question: "In the P0-P3 matrix, what priority level should login/authentication have?"
+      options:
+        A: "P3 - Low priority"
+        B: "P2 - Medium priority"
+        C: "P1 - High priority"
+        D: "P0 - Critical priority"
+      correct: D
+      explanation: "Login/authentication is P0 - critical. Business fails if broken. High usage, high impact, business-critical."
+
+    - id: q2-hard-waits
+      question: "What is the problem with using sleep(5000) instead of waitFor conditions?"
+      options:
+        A: "It makes tests slower"
+        B: "It's a hard wait that doesn't react to state changes (violates DoD)"
+        C: "It uses too much memory"
+        D: "It's not supported in modern frameworks"
+      correct: B
+      explanation: "Hard waits don't react to state changes - they guess timing. Use waitFor to react to conditions. This violates TEA Definition of Done."
+
+    - id: q3-self-cleaning
+      question: "What does 'self-cleaning tests' mean in TEA Definition of Done?"
+      options:
+        A: "Tests automatically fix their own bugs"
+        B: "Tests delete/deactivate entities they create during testing"
+        C: "Tests run faster by cleaning up code"
+        D: "Tests remove old test files"
+      correct: B
+      explanation: "Self-cleaning means tests delete/deactivate entities they created. No manual cleanup required."
+
+session-03-architecture:
+  passing_score: 70
+  questions:
+    - id: q1-fixtures
+      question: "What is the main benefit of fixture composition?"
+      options:
+        A: "Faster test execution"
+        B: "DRY - define once, reuse everywhere"
+        C: "Better error messages"
+        D: "Automatic screenshot capture"
+      correct: B
+      explanation: "Fixture composition allows you to define setup once and reuse everywhere. DRY principle for test setup."
+
+    - id: q2-network-first
+      question: "Why is 'network-first' better than mocking after the action?"
+      options:
+        A: "It's faster"
+        B: "It prevents race conditions"
+        C: "It uses less memory"
+        D: "It's easier to write"
+      correct: B
+      explanation: "Setting up network interception BEFORE the action prevents race conditions. The mock is ready when the action triggers."
+
+    - id: q3-step-file
+      question: "What pattern does this teaching workflow use?"
+      options:
+        A: "Page Object Model"
+        B: "Behavior Driven Development"
+        C: "Step-File Architecture"
+        D: "Test Pyramid"
+      correct: C
+      explanation: "This workflow uses step-file architecture: micro-file design, just-in-time loading, sequential enforcement."
+
+session-04-test-design:
+  passing_score: 70
+  questions:
+    - id: q1-test-design-purpose
+      question: "What does the Test Design workflow help you do?"
+      options:
+        A: "Write tests faster"
+        B: "Plan tests BEFORE writing them"
+        C: "Run tests in parallel"
+        D: "Debug test failures"
+      correct: B
+      explanation: "Test Design workflow helps you plan tests before writing them. Design before code, like architecture before implementation."
+
+    - id: q2-risk-calculation
+      question: "How do you calculate risk?"
+      options:
+        A: "Probability + Impact"
+        B: "Probability × Impact"
+        C: "Probability - Impact"
+        D: "Probability / Impact"
+      correct: B
+      explanation: "Risk = Probability × Impact. Multiply the likelihood of failure by the impact of failure."
+
+    - id: q3-p0-coverage
+      question: "For P0 features, which test levels should you use?"
+      options:
+        A: "Only E2E tests"
+        B: "Only unit tests"
+        C: "Unit + Integration + E2E (comprehensive)"
+        D: "Manual testing only"
+      correct: C
+      explanation: "P0 features need comprehensive coverage: Unit + Integration + E2E. High confidence for critical features."
+
+session-05-atdd-automate:
+  passing_score: 70
+  questions:
+    - id: q1-red-phase
+      question: "What is the 'red' phase in TDD?"
+      options:
+        A: "Tests fail (code doesn't exist yet)"
+        B: "Tests pass"
+        C: "Code is refactored"
+        D: "Tests are deleted"
+      correct: A
+      explanation: "Red phase: Tests fail because the code doesn't exist yet. Write tests first, then implement."
+
+    - id: q2-atdd-vs-automate
+      question: "What's the difference between ATDD and Automate workflows?"
+      options:
+        A: "ATDD generates E2E, Automate generates API tests"
+        B: "ATDD writes tests first (red phase), Automate tests existing code"
+        C: "ATDD is faster than Automate"
+        D: "They're the same workflow"
+      correct: B
+      explanation: "ATDD writes failing tests first (red phase), then you implement. Automate generates tests for existing code (coverage expansion)."
+
+    - id: q3-api-testing
+      question: "Why use pure API tests without a browser?"
+      options:
+        A: "They look prettier"
+        B: "They're easier to debug"
+        C: "They're faster and test business logic directly"
+        D: "They're required by TEA"
+      correct: C
+      explanation: "Pure API tests are faster (no browser overhead) and test business logic directly without UI complexity."
+
+session-06-quality-trace:
+  passing_score: 70
+  questions:
+    - id: q1-five-dimensions
+      question: "What are the 5 dimensions in Test Review workflow?"
+      options:
+        A: "Speed, cost, coverage, bugs, time"
+        B: "Determinism, Isolation, Assertions, Structure, Performance"
+        C: "Unit, integration, E2E, manual, exploratory"
+        D: "P0, P1, P2, P3, P4"
+      correct: B
+      explanation: "Test Review evaluates 5 dimensions: Determinism (no flakiness), Isolation (parallel-safe), Assertions (correct checks), Structure (readable/maintainable organization), Performance (speed)."
+
+    - id: q2-release-gate
+      question: "When should the Trace workflow gate decision be RED (block release)?"
+      options:
+        A: "Any test failures exist"
+        B: "P0 gaps exist (critical requirements not tested)"
+        C: "Code coverage is below 80%"
+        D: "Tests are slow"
+      correct: B
+      explanation: "RED gate when P0 gaps exist - critical requirements not tested. Don't ship if critical features lack test coverage."
+
+    - id: q3-metrics
+      question: "Which metric matters most for quality?"
+      options:
+        A: "Total line coverage %"
+        B: "Number of tests written"
+        C: "P0/P1 coverage %"
+        D: "Test file count"
+      correct: C
+      explanation: "P0/P1 coverage matters most - it measures coverage of critical/high-priority features. Total line coverage is a vanity metric."
+
+session-07-advanced:
+  # No quiz - exploratory session
+  # Score: 100 (completion based, not quiz based)
+  passing_score: 100
+  questions: []
--- a/.gemini/skills/bmad-teach-me-testing/data/role-paths.yaml
+++ b/.gemini/skills/bmad-teach-me-testing/data/role-paths.yaml
@@ -0,0 +1,136 @@
+# Role-Based Content Customization
+# Defines how teaching examples and focus areas adapt based on learner role
+
+roles:
+  qa:
+    display_name: "QA Engineer"
+    focus_areas:
+      - Practical testing workflow usage
+      - Test framework setup and maintenance
+      - Test quality and coverage metrics
+      - CI/CD integration
+    example_contexts:
+      - "Expanding test coverage for existing features"
+      - "Setting up test framework for new project"
+      - "Reducing flaky tests in CI pipeline"
+      - "Improving test execution speed"
+    recommended_sessions:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-03-architecture
+      - session-05-atdd-automate
+      - session-06-quality-trace
+    teaching_adaptations:
+      session-01-quickstart: "Focus on Automate workflow - quickly expand coverage"
+      session-02-concepts: "Emphasize P0-P3 for defending coverage decisions"
+      session-03-architecture: "Fixture patterns for maintainable test suites"
+      session-04-test-design: "Test design for planning coverage expansion"
+      session-05-atdd-automate: "ATDD and Automate for test generation"
+      session-06-quality-trace: "Test Review for quality metrics reporting"
+      session-07-advanced: "Playwright Utils for advanced testing patterns"
+
+  dev:
+    display_name: "Software Developer"
+    focus_areas:
+      - Integration testing perspective
+      - TDD approach
+      - Test-driven development workflow
+      - Unit and integration tests
+    example_contexts:
+      - "Writing tests alongside feature development"
+      - "Using ATDD to drive implementation"
+      - "Integrating tests into development workflow"
+      - "Testing APIs and business logic"
+    recommended_sessions:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-05-atdd-automate
+      - session-03-architecture
+      - session-04-test-design
+    teaching_adaptations:
+      session-01-quickstart: "Focus on ATDD - tests drive implementation"
+      session-02-concepts: "Connect DoD to code quality standards"
+      session-03-architecture: "Fixtures as code patterns, like dependency injection"
+      session-04-test-design: "Risk assessment before writing code"
+      session-05-atdd-automate: "Red-green-refactor TDD cycle"
+      session-06-quality-trace: "Test quality like code quality - refactoring applies"
+      session-07-advanced: "API testing patterns, component TDD"
+
+  lead:
+    display_name: "Tech Lead / Engineering Manager"
+    focus_areas:
+      - Test architecture decisions
+      - Team testing patterns
+      - Framework and tooling choices
+      - Quality standards enforcement
+    example_contexts:
+      - "Establishing team testing standards"
+      - "Choosing test architecture patterns"
+      - "Code review for test quality"
+      - "Scaling test automation across team"
+    recommended_sessions:
+      - session-01-quickstart
+      - session-03-architecture
+      - session-04-test-design
+      - session-06-quality-trace
+      - session-07-advanced
+    teaching_adaptations:
+      session-01-quickstart: "TEA as team standard - scalable patterns"
+      session-02-concepts: "DoD as code review checklist - enforce quality"
+      session-03-architecture: "Architecture patterns for team consistency"
+      session-04-test-design: "Test design as planning phase in development"
+      session-05-atdd-automate: "ATDD for team TDD adoption"
+      session-06-quality-trace: "Test Review for quality metrics and team standards"
+      session-07-advanced: "Step-file architecture, fixture patterns, CI governance"
+
+  vp:
+    display_name: "VP Engineering / Director"
+    focus_areas:
+      - Testing strategy and ROI
+      - Quality metrics that matter
+      - Team scalability
+      - Risk management through testing
+    example_contexts:
+      - "Justifying test automation investment"
+      - "Scaling testing across multiple teams"
+      - "Quality metrics for stakeholder reporting"
+      - "Risk mitigation through test coverage"
+    recommended_sessions:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-04-test-design
+      - session-06-quality-trace
+    teaching_adaptations:
+      session-01-quickstart: "TEA scales testing without scaling headcount"
+      session-02-concepts: "Risk-based testing aligns engineering with business impact"
+      session-03-architecture: "Architecture patterns reduce maintenance costs"
+      session-04-test-design: "Test design makes risk visible to stakeholders"
+      session-05-atdd-automate: "ATDD reduces defect rates early"
+      session-06-quality-trace: "Quality metrics: P0/P1 coverage, not vanity metrics"
+      session-07-advanced: "Governance patterns, CI orchestration, NFR assessment"
+
+# Role-Based Example Types
+example_types:
+  qa:
+    - "Test suite maintenance scenarios"
+    - "Coverage expansion projects"
+    - "Flaky test debugging"
+    - "CI pipeline configuration"
+
+  dev:
+    - "Feature development with TDD"
+    - "API integration testing"
+    - "Unit test patterns"
+    - "Mocking and stubbing"
+
+  lead:
+    - "Team architecture decisions"
+    - "Code review scenarios"
+    - "Standard enforcement"
+    - "Tooling selection"
+
+  vp:
+    - "ROI calculations"
+    - "Quality dashboards"
+    - "Risk reporting"
+    - "Team scaling strategies"
--- a/.gemini/skills/bmad-teach-me-testing/data/session-content-map.yaml
+++ b/.gemini/skills/bmad-teach-me-testing/data/session-content-map.yaml
@@ -0,0 +1,207 @@
+# Session Content Mapping
+# Maps each session to specific TEA documentation, knowledge fragments, and online resources
+
+base_paths:
+  tea_docs: "/docs"
+  tea_knowledge: "/src/testarch/knowledge"
+  online_base: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise"
+  github_knowledge: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
+
+sessions:
+  session-01-quickstart:
+    docs:
+      - path: "/docs/tutorials/tea-lite-quickstart.md"
+        title: "TEA Lite Quickstart"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/tutorials/tea-lite-quickstart/"
+      - path: "/docs/explanation/tea-overview.md"
+        title: "TEA Overview"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/tea-overview/"
+      - path: "/docs/how-to/workflows/run-automate.md"
+        title: "Run Automate Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/"
+    knowledge_fragments: []
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/"
+    workflows_referenced:
+      - automate
+    key_concepts:
+      - "What is TEA"
+      - "TEA Lite approach"
+      - "Engagement models"
+      - "9 workflows overview"
+
+  session-02-concepts:
+    docs:
+      - path: "/docs/explanation/testing-as-engineering.md"
+        title: "Testing as Engineering"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/testing-as-engineering/"
+      - path: "/docs/explanation/risk-based-testing.md"
+        title: "Risk-Based Testing"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/risk-based-testing/"
+      - path: "/docs/explanation/test-quality-standards.md"
+        title: "Test Quality Standards"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/test-quality-standards/"
+    knowledge_fragments:
+      - path: "/src/testarch/knowledge/test-quality.md"
+        title: "Test Quality (DoD Execution Limits)"
+      - path: "/src/testarch/knowledge/probability-impact.md"
+        title: "Probability × Impact Scoring"
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/testing-as-engineering/"
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/risk-based-testing/"
+    workflows_referenced: []
+    key_concepts:
+      - "Testing as engineering philosophy"
+      - "P0-P3 risk matrix"
+      - "Probability × Impact scoring"
+      - "Definition of Done (7 principles)"
+
+  session-03-architecture:
+    docs:
+      - path: "/docs/explanation/fixture-architecture.md"
+        title: "Fixture Architecture"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/fixture-architecture/"
+      - path: "/docs/explanation/network-first-patterns.md"
+        title: "Network-First Patterns"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/network-first-patterns/"
+      - path: "/docs/explanation/step-file-architecture.md"
+        title: "Step-File Architecture"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/step-file-architecture/"
+    knowledge_fragments:
+      - path: "/src/testarch/knowledge/fixture-architecture.md"
+        title: "Fixture Architecture Patterns"
+      - path: "/src/testarch/knowledge/network-first.md"
+        title: "Network-First Implementation"
+      - path: "/src/testarch/knowledge/data-factories.md"
+        title: "Data Factories Pattern"
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/explanation/fixture-architecture/"
+    workflows_referenced:
+      - framework
+    key_concepts:
+      - "Fixture composition"
+      - "Network interception patterns"
+      - "Data factory pattern"
+      - "Step-file architecture"
+
+  session-04-test-design:
+    docs:
+      - path: "/docs/how-to/workflows/run-test-design.md"
+        title: "Run Test Design Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/"
+    knowledge_fragments:
+      - path: "/src/testarch/knowledge/test-levels-framework.md"
+        title: "Test Levels Framework"
+      - path: "/src/testarch/knowledge/test-priorities-matrix.md"
+        title: "Test Priorities Matrix"
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-design/"
+    workflows_referenced:
+      - test-design
+    key_concepts:
+      - "Test Design workflow steps"
+      - "Risk/testability assessment"
+      - "Coverage planning"
+      - "Test levels (unit/integration/E2E)"
+
+  session-05-atdd-automate:
+    docs:
+      - path: "/docs/how-to/workflows/run-atdd.md"
+        title: "Run ATDD Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-atdd/"
+      - path: "/docs/how-to/workflows/run-automate.md"
+        title: "Run Automate Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/"
+    knowledge_fragments:
+      - path: "/src/testarch/knowledge/component-tdd.md"
+        title: "Component TDD Red-Green Loop"
+      - path: "/src/testarch/knowledge/api-testing-patterns.md"
+        title: "API Testing Patterns"
+      - path: "/src/testarch/knowledge/api-request.md"
+        title: "API Request Utility"
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-atdd/"
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-automate/"
+    workflows_referenced:
+      - atdd
+      - automate
+    key_concepts:
+      - "ATDD workflow (red phase)"
+      - "TDD red-green-refactor"
+      - "Automate workflow (coverage expansion)"
+      - "API testing without browser"
+
+  session-06-quality-trace:
+    docs:
+      - path: "/docs/how-to/workflows/run-test-review.md"
+        title: "Run Test Review Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/"
+      - path: "/docs/how-to/workflows/run-trace.md"
+        title: "Run Trace Workflow"
+        url: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/"
+    knowledge_fragments: []
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-test-review/"
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/how-to/workflows/run-trace/"
+    workflows_referenced:
+      - test-review
+      - trace
+    key_concepts:
+      - "5 dimensions of test quality"
+      - "Quality scoring (0-100)"
+      - "Requirements traceability"
+      - "Release gate decisions"
+
+  session-07-advanced:
+    docs: []
+    knowledge_fragments:
+      categories:
+        testing_patterns:
+          - fixture-architecture.md
+          - network-first.md
+          - data-factories.md
+          - component-tdd.md
+          - api-testing-patterns.md
+          - test-healing-patterns.md
+          - selector-resilience.md
+          - timing-debugging.md
+
+        playwright_utils:
+          - api-request.md
+          - network-recorder.md
+          - intercept-network-call.md
+          - recurse.md
+          - log.md
+          - file-utils.md
+          - burn-in.md
+          - network-error-monitor.md
+          - contract-testing.md
+
+        browser_automation:
+          - playwright-cli.md
+
+        configuration_governance:
+          - playwright-config.md
+          - ci-burn-in.md
+          - selective-testing.md
+          - feature-flags.md
+          - risk-governance.md
+
+        quality_frameworks:
+          - test-quality.md
+          - test-levels-framework.md
+          - test-priorities-matrix.md
+          - nfr-criteria.md
+
+        auth_security:
+          - email-auth.md
+          - auth-session.md
+          - error-handling.md
+    online_references:
+      - "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/reference/knowledge-base/"
+      - "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
+    workflows_referenced: []
+    key_concepts:
+      - "Menu-driven fragment exploration"
+      - "Just-in-time deep-dive learning"
+      - "35 knowledge fragments organized by category"
--- a/.gemini/skills/bmad-teach-me-testing/data/tea-resources-index.yaml
+++ b/.gemini/skills/bmad-teach-me-testing/data/tea-resources-index.yaml
@@ -0,0 +1,359 @@
+# TEA Resources Index
+# Comprehensive index of TEA documentation, knowledge fragments, and online resources
+
+base_urls:
+  online_docs: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise"
+  github_repo: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise"
+  github_knowledge: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
+
+# Public Documentation (32 files)
+documentation:
+  tutorials:
+    - name: "Getting Started with Test Architect"
+      local: "/docs/tutorials/tea-lite-quickstart.md"
+      online: "/tutorials/tea-lite-quickstart/"
+      description: "30-minute quick start guide to TEA Lite"
+
+  how_to_guides:
+    workflows:
+      - name: "Set Up Test Framework"
+        local: "/docs/how-to/workflows/setup-test-framework.md"
+        online: "/how-to/workflows/setup-test-framework/"
+        workflow: framework
+
+      - name: "Set Up CI Pipeline"
+        local: "/docs/how-to/workflows/setup-ci.md"
+        online: "/how-to/workflows/setup-ci/"
+        workflow: ci
+
+      - name: "Test Design"
+        local: "/docs/how-to/workflows/run-test-design.md"
+        online: "/how-to/workflows/run-test-design/"
+        workflow: test-design
+
+      - name: "ATDD"
+        local: "/docs/how-to/workflows/run-atdd.md"
+        online: "/how-to/workflows/run-atdd/"
+        workflow: atdd
+
+      - name: "Automate"
+        local: "/docs/how-to/workflows/run-automate.md"
+        online: "/how-to/workflows/run-automate/"
+        workflow: automate
+
+      - name: "Test Review"
+        local: "/docs/how-to/workflows/run-test-review.md"
+        online: "/how-to/workflows/run-test-review/"
+        workflow: test-review
+
+      - name: "Trace"
+        local: "/docs/how-to/workflows/run-trace.md"
+        online: "/how-to/workflows/run-trace/"
+        workflow: trace
+
+      - name: "NFR Assessment"
+        local: "/docs/how-to/workflows/run-nfr-assess.md"
+        online: "/how-to/workflows/run-nfr-assess/"
+        workflow: nfr-assess
+
+    customization:
+      - name: "Configure Browser Automation"
+        local: "/docs/how-to/customization/configure-browser-automation.md"
+        online: "/how-to/customization/configure-browser-automation/"
+
+      - name: "Integrate Playwright Utils with TEA"
+        local: "/docs/how-to/customization/integrate-playwright-utils.md"
+        online: "/how-to/customization/integrate-playwright-utils/"
+
+    brownfield:
+      - name: "Running TEA for Enterprise Projects"
+        local: "/docs/how-to/brownfield/use-tea-for-enterprise.md"
+        online: "/how-to/brownfield/use-tea-for-enterprise/"
+
+      - name: "Using TEA with Existing Tests"
+        local: "/docs/how-to/brownfield/use-tea-with-existing-tests.md"
+        online: "/how-to/brownfield/use-tea-with-existing-tests/"
+
+  explanation:
+    - name: "TEA Overview"
+      local: "/docs/explanation/tea-overview.md"
+      online: "/explanation/tea-overview/"
+      topics: ["Architecture", "Engagement models"]
+
+    - name: "Testing as Engineering"
+      local: "/docs/explanation/testing-as-engineering.md"
+      online: "/explanation/testing-as-engineering/"
+      topics: ["Philosophy", "Design principles"]
+
+    - name: "Engagement Models"
+      local: "/docs/explanation/engagement-models.md"
+      online: "/explanation/engagement-models/"
+      topics: ["Lite", "Solo", "Integrated", "Enterprise", "Brownfield"]
+
+    - name: "Risk-Based Testing"
+      local: "/docs/explanation/risk-based-testing.md"
+      online: "/explanation/risk-based-testing/"
+      topics: ["P0-P3 matrix", "Probability × Impact"]
+
+    - name: "Test Quality Standards"
+      local: "/docs/explanation/test-quality-standards.md"
+      online: "/explanation/test-quality-standards/"
+      topics: ["Definition of Done", "7 principles"]
+
+    - name: "Knowledge Base System"
+      local: "/docs/explanation/knowledge-base-system.md"
+      online: "/explanation/knowledge-base-system/"
+      topics: ["Fragment management", "35 fragments"]
+
+    - name: "Network-First Patterns"
+      local: "/docs/explanation/network-first-patterns.md"
+      online: "/explanation/network-first-patterns/"
+      topics: ["Network interception", "Race condition prevention"]
+
+    - name: "Fixture Architecture"
+      local: "/docs/explanation/fixture-architecture.md"
+      online: "/explanation/fixture-architecture/"
+      topics: ["Composition", "mergeTests pattern"]
+
+    - name: "Step-File Architecture"
+      local: "/docs/explanation/step-file-architecture.md"
+      online: "/explanation/step-file-architecture/"
+      topics: ["Micro-file design", "JIT loading", "Sequential enforcement"]
+
+    - name: "Subagent Architecture"
+      local: "/docs/explanation/subagent-architecture.md"
+      online: "/explanation/subagent-architecture/"
+      topics: ["Parallel execution", "Context optimization"]
+
+  reference:
+    - name: "Commands"
+      local: "/docs/reference/commands.md"
+      online: "/reference/commands/"
+
+    - name: "Configuration"
+      local: "/docs/reference/configuration.md"
+      online: "/reference/configuration/"
+
+    - name: "Knowledge Base"
+      local: "/docs/reference/knowledge-base.md"
+      online: "/reference/knowledge-base/"
+      github_link: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
+
+    - name: "Troubleshooting"
+      local: "/docs/reference/troubleshooting.md"
+      online: "/reference/troubleshooting/"
+
+# Knowledge Fragments (34 files)
+knowledge_fragments:
+  testing_patterns:
+    - name: "fixture-architecture"
+      path: "/src/testarch/knowledge/fixture-architecture.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/fixture-architecture.md"
+      description: "Composable fixture patterns and mergeTests"
+
+    - name: "fixtures-composition"
+      path: "/src/testarch/knowledge/fixtures-composition.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/fixtures-composition.md"
+      description: "mergeTests composition patterns for combining utilities"
+
+    - name: "network-first"
+      path: "/src/testarch/knowledge/network-first.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-first.md"
+      description: "Network interception safeguards"
+
+    - name: "data-factories"
+      path: "/src/testarch/knowledge/data-factories.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/data-factories.md"
+      description: "Data seeding and setup patterns"
+
+    - name: "component-tdd"
+      path: "/src/testarch/knowledge/component-tdd.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/component-tdd.md"
+      description: "TDD red-green-refactor loop"
+
+    - name: "api-testing-patterns"
+      path: "/src/testarch/knowledge/api-testing-patterns.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/api-testing-patterns.md"
+      description: "Pure API testing without browser"
+
+    - name: "test-healing-patterns"
+      path: "/src/testarch/knowledge/test-healing-patterns.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-healing-patterns.md"
+      description: "Auto-fix common test failures"
+
+    - name: "selector-resilience"
+      path: "/src/testarch/knowledge/selector-resilience.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/selector-resilience.md"
+      description: "Robust selectors that don't break"
+
+    - name: "timing-debugging"
+      path: "/src/testarch/knowledge/timing-debugging.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/timing-debugging.md"
+      description: "Race condition fixes"
+
+  playwright_utils:
+    - name: "overview"
+      path: "/src/testarch/knowledge/overview.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/overview.md"
+      description: "Playwright Utils overview and installation"
+
+    - name: "api-request"
+      path: "/src/testarch/knowledge/api-request.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/api-request.md"
+      description: "Typed HTTP client with schema validation"
+
+    - name: "network-recorder"
+      path: "/src/testarch/knowledge/network-recorder.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-recorder.md"
+      description: "HAR record and playback"
+
+    - name: "intercept-network-call"
+      path: "/src/testarch/knowledge/intercept-network-call.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/intercept-network-call.md"
+      description: "Network spy and stub utilities"
+
+    - name: "recurse"
+      path: "/src/testarch/knowledge/recurse.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/recurse.md"
+      description: "Async polling for eventual consistency"
+
+    - name: "log"
+      path: "/src/testarch/knowledge/log.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/log.md"
+      description: "Test report logging utilities"
+
+    - name: "file-utils"
+      path: "/src/testarch/knowledge/file-utils.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/file-utils.md"
+      description: "CSV/XLSX/PDF/ZIP validation"
+
+    - name: "burn-in"
+      path: "/src/testarch/knowledge/burn-in.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/burn-in.md"
+      description: "Smart test selection via git diff"
+
+    - name: "network-error-monitor"
+      path: "/src/testarch/knowledge/network-error-monitor.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-error-monitor.md"
+      description: "HTTP 4xx/5xx detection"
+
+    - name: "contract-testing"
+      path: "/src/testarch/knowledge/contract-testing.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/contract-testing.md"
+      description: "Pact publishing and provider verification"
+
+    - name: "visual-debugging"
+      path: "/src/testarch/knowledge/visual-debugging.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/visual-debugging.md"
+      description: "Trace viewer workflows and debugging artifacts"
+
+  configuration_governance:
+    - name: "playwright-config"
+      path: "/src/testarch/knowledge/playwright-config.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/playwright-config.md"
+      description: "Environment and timeout guardrails"
+
+    - name: "ci-burn-in"
+      path: "/src/testarch/knowledge/ci-burn-in.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/ci-burn-in.md"
+      description: "CI orchestration and smart selection"
+
+    - name: "selective-testing"
+      path: "/src/testarch/knowledge/selective-testing.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/selective-testing.md"
+      description: "Tag and grep filters"
+
+    - name: "feature-flags"
+      path: "/src/testarch/knowledge/feature-flags.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/feature-flags.md"
+      description: "Feature flag governance and cleanup"
+
+    - name: "risk-governance"
+      path: "/src/testarch/knowledge/risk-governance.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/risk-governance.md"
+      description: "Risk scoring matrix and gate rules"
+
+    - name: "adr-quality-readiness-checklist"
+      path: "/src/testarch/knowledge/adr-quality-readiness-checklist.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/adr-quality-readiness-checklist.md"
+      description: "Quality readiness checklist for decisions and reviews"
+
+  quality_frameworks:
+    - name: "test-quality"
+      path: "/src/testarch/knowledge/test-quality.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-quality.md"
+      description: "Definition of Done execution limits"
+
+    - name: "test-levels-framework"
+      path: "/src/testarch/knowledge/test-levels-framework.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-levels-framework.md"
+      description: "Unit/Integration/E2E selection criteria"
+
+    - name: "test-priorities-matrix"
+      path: "/src/testarch/knowledge/test-priorities-matrix.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-priorities-matrix.md"
+      description: "P0-P3 coverage targets"
+
+    - name: "probability-impact"
+      path: "/src/testarch/knowledge/probability-impact.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/probability-impact.md"
+      description: "Probability × impact scoring definitions"
+
+    - name: "nfr-criteria"
+      path: "/src/testarch/knowledge/nfr-criteria.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/nfr-criteria.md"
+      description: "Non-functional requirements assessment"
+
+  auth_security:
+    - name: "email-auth"
+      path: "/src/testarch/knowledge/email-auth.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/email-auth.md"
+      description: "Magic link extraction and auth state"
+
+    - name: "auth-session"
+      path: "/src/testarch/knowledge/auth-session.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/auth-session.md"
+      description: "Token persistence and multi-user auth"
+
+    - name: "error-handling"
+      path: "/src/testarch/knowledge/error-handling.md"
+      github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/error-handling.md"
+      description: "Exception handling and retry validation"
+
+# Quick Reference Maps
+session_to_resources:
+  session-01:
+    primary_docs: ["tea-lite-quickstart", "tea-overview", "run-automate"]
+    fragments: []
+
+  session-02:
+    primary_docs: ["testing-as-engineering", "risk-based-testing", "test-quality-standards"]
+    fragments: ["test-quality", "probability-impact"]
+
+  session-03:
+    primary_docs: ["fixture-architecture", "network-first-patterns", "step-file-architecture"]
+    fragments: ["fixture-architecture", "network-first", "data-factories"]
+
+  session-04:
+    primary_docs: ["run-test-design"]
+    fragments: ["test-levels-framework", "test-priorities-matrix"]
+
+  session-05:
+    primary_docs: ["run-atdd", "run-automate"]
+    fragments: ["component-tdd", "api-testing-patterns", "api-request"]
+
+  session-06:
+    primary_docs: ["run-test-review", "run-trace"]
+    fragments: []
+
+  session-07:
+    primary_docs: []
+    fragments: [] # All 35 fragments available via menu-driven exploration
+
+# Web-Browsing Fallback Strategy
+fallback_urls:
+  playwright_docs: "https://playwright.dev/docs/intro"
+  jest_docs: "https://jestjs.io/docs/getting-started"
+  cypress_docs: "https://docs.cypress.io/guides/overview/why-cypress"
+  vitest_docs: "https://vitest.dev/guide/"
+  testing_library: "https://testing-library.com/docs/"