froid-plane-test-architecture-enterprise 1.23.4

package/src/workflows/testarch/froid-teach-me-testing/data/tea-resources-index.yaml

@@ -0,0 +1,483 @@
+# TEA Resources Index
+# Comprehensive index of TEA documentation, knowledge fragments, and online resources
+
+base_urls:
+  online_docs: "https://cordya-ai.github.io/froid-plane-test-architecture-enterprise"
+  github_repo: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise"
+  github_knowledge: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/tree/main/src/agents/froid-tea/resources/knowledge"
+
+# Public Documentation (27 entries)
+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 Evidence Audit"
+        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/"
+
+      - name: "Integrate Pact.js Utils with TEA"
+        local: "/docs/how-to/customization/integrate-pactjs-utils.md"
+        online: "/how-to/customization/integrate-pactjs-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", "59 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 Files & Orchestration"
+      local: "/docs/explanation/step-file-architecture.md"
+      online: "/explanation/step-file-architecture/"
+      topics: ["Micro-file design", "JIT loading", "Sequential enforcement", "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/cordya-ai/froid-plane-test-architecture-enterprise/tree/main/src/agents/froid-tea/resources/knowledge"
+
+    - name: "Troubleshooting"
+      local: "/docs/reference/troubleshooting.md"
+      online: "/reference/troubleshooting/"
+
+# Knowledge Fragments (59 files)
+knowledge_fragments:
+  testing_patterns:
+    - name: "fixture-architecture"
+      path: "/src/agents/froid-tea/resources/knowledge/fixture-architecture.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/fixture-architecture.md"
+      description: "Composable fixture patterns and mergeTests"
+
+    - name: "fixtures-composition"
+      path: "/src/agents/froid-tea/resources/knowledge/fixtures-composition.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/fixtures-composition.md"
+      description: "mergeTests composition patterns for combining utilities"
+
+    - name: "network-first"
+      path: "/src/agents/froid-tea/resources/knowledge/network-first.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/network-first.md"
+      description: "Network interception safeguards"
+
+    - name: "data-factories"
+      path: "/src/agents/froid-tea/resources/knowledge/data-factories.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/data-factories.md"
+      description: "Data seeding and setup patterns"
+
+    - name: "component-tdd"
+      path: "/src/agents/froid-tea/resources/knowledge/component-tdd.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/component-tdd.md"
+      description: "TDD red-green-refactor loop"
+
+    - name: "api-testing-patterns"
+      path: "/src/agents/froid-tea/resources/knowledge/api-testing-patterns.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/api-testing-patterns.md"
+      description: "Pure API testing without browser"
+
+    - name: "test-healing-patterns"
+      path: "/src/agents/froid-tea/resources/knowledge/test-healing-patterns.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/test-healing-patterns.md"
+      description: "Auto-fix common test failures"
+
+    - name: "selector-resilience"
+      path: "/src/agents/froid-tea/resources/knowledge/selector-resilience.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/selector-resilience.md"
+      description: "Robust selectors that don't break"
+
+    - name: "timing-debugging"
+      path: "/src/agents/froid-tea/resources/knowledge/timing-debugging.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/timing-debugging.md"
+      description: "Race condition fixes"
+
+    - name: "maestro-flows"
+      path: "/src/agents/froid-tea/resources/knowledge/maestro-flows.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/maestro-flows.md"
+      description: "Declarative mobile flow structure, selector hierarchy (id > text > scoped text), clearState"
+
+    - name: "mobile-test-strategy"
+      path: "/src/agents/froid-tea/resources/knowledge/mobile-test-strategy.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/mobile-test-strategy.md"
+      description: "Mobile test level framework (unit/component/contract/device flow), what belongs in a device"
+
+    - name: "mobile-ci-device-lab"
+      path: "/src/agents/froid-tea/resources/knowledge/mobile-ci-device-lab.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/mobile-ci-device-lab.md"
+      description: "Build artifact selection, emulator snapshot caching, runner version pinning, failure diagnosis"
+
+    - name: "playwright-cli"
+      path: "/src/agents/froid-tea/resources/knowledge/playwright-cli.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/playwright-cli.md"
+      description: "Token-efficient CLI for AI coding agents: element refs, sessions, snapshots, trace"
+
+  playwright_utils:
+    - name: "overview"
+      path: "/src/agents/froid-tea/resources/knowledge/overview.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/overview.md"
+      description: "Playwright Utils overview and installation"
+
+    - name: "library-integration-mandate"
+      path: "/src/agents/froid-tea/resources/knowledge/library-integration-mandate.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/library-integration-mandate.md"
+      description: "The general rule behind every integration flag, and how to add the next library"
+
+    - name: "playwright-utils-mandate"
+      path: "/src/agents/froid-tea/resources/knowledge/playwright-utils-mandate.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/playwright-utils-mandate.md"
+      description: "When the flag is on: what replaces what, and what is a real exception"
+
+    - name: "api-request"
+      path: "/src/agents/froid-tea/resources/knowledge/api-request.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/api-request.md"
+      description: "Typed HTTP client with schema validation"
+
+    - name: "network-recorder"
+      path: "/src/agents/froid-tea/resources/knowledge/network-recorder.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/network-recorder.md"
+      description: "HAR record and playback"
+
+    - name: "intercept-network-call"
+      path: "/src/agents/froid-tea/resources/knowledge/intercept-network-call.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/intercept-network-call.md"
+      description: "Network spy and stub utilities"
+
+    - name: "recurse"
+      path: "/src/agents/froid-tea/resources/knowledge/recurse.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/recurse.md"
+      description: "Async polling for eventual consistency"
+
+    - name: "log"
+      path: "/src/agents/froid-tea/resources/knowledge/log.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/log.md"
+      description: "Test report logging utilities"
+
+    - name: "file-utils"
+      path: "/src/agents/froid-tea/resources/knowledge/file-utils.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/file-utils.md"
+      description: "CSV/XLSX/PDF/ZIP validation"
+
+    - name: "burn-in"
+      path: "/src/agents/froid-tea/resources/knowledge/burn-in.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/burn-in.md"
+      description: "Smart test selection via git diff"
+
+    - name: "network-error-monitor"
+      path: "/src/agents/froid-tea/resources/knowledge/network-error-monitor.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/network-error-monitor.md"
+      description: "HTTP 4xx/5xx detection"
+
+    - name: "contract-testing"
+      path: "/src/agents/froid-tea/resources/knowledge/contract-testing.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/contract-testing.md"
+      description: "Pact publishing and provider verification"
+
+    - name: "pactjs-utils-overview"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-overview.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-overview.md"
+      description: "Pact.js Utils installation and contract testing flows"
+
+    - name: "pactjs-utils-mandate"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-mandate.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-mandate.md"
+      description: "When the flag is on: what replaces raw Pact, and when a Pact suite belongs at all"
+
+    - name: "pactjs-utils-consumer-helpers"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-consumer-helpers.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-consumer-helpers.md"
+      description: "Consumer-side Pact helpers (createProviderState, toJsonMap)"
+
+    - name: "pactjs-utils-provider-verifier"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-provider-verifier.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-provider-verifier.md"
+      description: "Provider verification options builders"
+
+    - name: "pactjs-utils-request-filter"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-request-filter.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-request-filter.md"
+      description: "Request filter for auth injection in provider verification"
+
+    - name: "pact-mcp"
+      path: "/src/agents/froid-tea/resources/knowledge/pact-mcp.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pact-mcp.md"
+      description: "SmartBear MCP server for PactFlow tooling setup"
+
+    - name: "pact-consumer-framework-setup"
+      path: "/src/agents/froid-tea/resources/knowledge/pact-consumer-framework-setup.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pact-consumer-framework-setup.md"
+      description: "Consumer CDC framework directory structure and CI workflow"
+
+    - name: "pact-consumer-di"
+      path: "/src/agents/froid-tea/resources/knowledge/pact-consumer-di.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pact-consumer-di.md"
+      description: "Dependency injection pattern for Pact consumer tests"
+
+    - name: "visual-debugging"
+      path: "/src/agents/froid-tea/resources/knowledge/visual-debugging.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/visual-debugging.md"
+      description: "Trace viewer workflows and debugging artifacts"
+
+    - name: "webhook-testing-fundamentals"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-testing-fundamentals.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-testing-fundamentals.md"
+      description: "Why webhook delivery is hard: async, parallel pollution, opaque timeouts, cleanup drift"
+
+    - name: "webhook-module-setup"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-module-setup.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-module-setup.md"
+      description: "Fixture wiring for WireMock/MockServer/Mockoon providers, matched-only vs full-reset"
+
+    - name: "webhook-template-matchers"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-template-matchers.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-template-matchers.md"
+      description: "matchField (dot-path exact), matchPartial (deep subset), matchPredicate (arbitrary fn), AND"
+
+    - name: "webhook-waiting-querying"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-waiting-querying.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-waiting-querying.md"
+      description: "waitFor, waitForCount, getReceived, drain pattern for sequential events, parallel worker"
+
+    - name: "webhook-timeout-error"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-timeout-error.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-timeout-error.md"
+      description: "templateName, timeoutMs, totalReceived, receivedWebhooks, matcherDetails, toJSON — inspect"
+
+    - name: "webhook-providers"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-providers.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-providers.md"
+      description: "WireMock (deleteById supported), MockServer (deleteById no-op), Mockoon (deleteById no-op"
+
+    - name: "webhook-risk-guidance"
+      path: "/src/agents/froid-tea/resources/knowledge/webhook-risk-guidance.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/webhook-risk-guidance.md"
+      description: "When webhook tests are required, P2×I3 default risk score, complete test checklist, failure"
+
+  configuration_governance:
+    - name: "playwright-config"
+      path: "/src/agents/froid-tea/resources/knowledge/playwright-config.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/playwright-config.md"
+      description: "Environment and timeout guardrails"
+
+    - name: "ci-burn-in"
+      path: "/src/agents/froid-tea/resources/knowledge/ci-burn-in.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/ci-burn-in.md"
+      description: "CI orchestration and smart selection"
+
+    - name: "selective-testing"
+      path: "/src/agents/froid-tea/resources/knowledge/selective-testing.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/selective-testing.md"
+      description: "Tag and grep filters"
+
+    - name: "feature-flags"
+      path: "/src/agents/froid-tea/resources/knowledge/feature-flags.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/feature-flags.md"
+      description: "Feature flag governance and cleanup"
+
+    - name: "risk-governance"
+      path: "/src/agents/froid-tea/resources/knowledge/risk-governance.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/risk-governance.md"
+      description: "Risk scoring matrix and gate rules"
+
+    - name: "adr-quality-readiness-checklist"
+      path: "/src/agents/froid-tea/resources/knowledge/adr-quality-readiness-checklist.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/adr-quality-readiness-checklist.md"
+      description: "Quality readiness checklist for decisions and reviews"
+
+  quality_frameworks:
+    - name: "test-quality"
+      path: "/src/agents/froid-tea/resources/knowledge/test-quality.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/test-quality.md"
+      description: "Definition of Done execution limits"
+
+    - name: "test-levels-framework"
+      path: "/src/agents/froid-tea/resources/knowledge/test-levels-framework.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/test-levels-framework.md"
+      description: "Unit/Integration/E2E selection criteria"
+
+    - name: "test-priorities-matrix"
+      path: "/src/agents/froid-tea/resources/knowledge/test-priorities-matrix.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/test-priorities-matrix.md"
+      description: "P0-P3 coverage targets"
+
+    - name: "probability-impact"
+      path: "/src/agents/froid-tea/resources/knowledge/probability-impact.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/probability-impact.md"
+      description: "Probability × impact scoring definitions"
+
+    - name: "nfr-criteria"
+      path: "/src/agents/froid-tea/resources/knowledge/nfr-criteria.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/nfr-criteria.md"
+      description: "Non-functional requirements assessment"
+
+    - name: "confidence-gate"
+      path: "/src/agents/froid-tea/resources/knowledge/confidence-gate.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/confidence-gate.md"
+      description: "1-10 confidence scoring with stop-and-ask rule below threshold for selectors, endpoints"
+
+    - name: "evidence-integrity"
+      path: "/src/agents/froid-tea/resources/knowledge/evidence-integrity.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/evidence-integrity.md"
+      description: "Checks that cannot fail, three-state diagnostics, and verdicts a probe did not earn"
+
+  auth_security:
+    - name: "email-auth"
+      path: "/src/agents/froid-tea/resources/knowledge/email-auth.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/email-auth.md"
+      description: "Magic link extraction and auth state"
+
+    - name: "auth-session"
+      path: "/src/agents/froid-tea/resources/knowledge/auth-session.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/auth-session.md"
+      description: "Token persistence and multi-user auth"
+
+    - name: "error-handling"
+      path: "/src/agents/froid-tea/resources/knowledge/error-handling.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/error-handling.md"
+      description: "Exception handling and retry validation"
+
+    - name: "pact-broker-webhooks"
+      path: "/src/agents/froid-tea/resources/knowledge/pact-broker-webhooks.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pact-broker-webhooks.md"
+      description: "PactFlow → GitHub repository_dispatch auth via dedicated machine user + classic PAT (repo"
+
+    - name: "pactjs-utils-zod-to-pact"
+      path: "/src/agents/froid-tea/resources/knowledge/pactjs-utils-zod-to-pact.md"
+      github: "https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/blob/main/src/agents/froid-tea/resources/knowledge/pactjs-utils-zod-to-pact.md"
+      description: "zodToPactMatchers for consumer-curated schemas, example precedence, Pact V3 matcher"
+
+# 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 59 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/"

package/src/workflows/testarch/froid-teach-me-testing/instructions.md

@@ -0,0 +1,129 @@
+# Teach Me Testing - Usage Instructions
+
+## Overview
+
+The Teach Me Testing workflow is a multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence. Designed for self-paced learning over 1-2 weeks.
+
+## Who Should Use This
+
+- **New QA Engineers:** Complete onboarding in testing fundamentals
+- **Developers:** Learn testing from an integration perspective
+- **Team Leads:** Understand architecture patterns and team practices
+- **VPs/Managers:** Grasp testing strategy and quality metrics
+
+## How to Run
+
+### Starting Fresh
+
+Invoke the skill directly:
+
+- Claude Code, Cursor, Windsurf: `/froid-teach-me-testing`
+- Codex: `$froid-teach-me-testing`
+
+Or activate the TEA agent (`/froid-tea` or `$froid-tea`) and select menu code `TMT`.
+
+### Continuing Existing Progress
+
+The workflow automatically detects existing progress and resumes where you left off. Your progress is saved at:
+
+- `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
+
+## Workflow Structure
+
+### Step Entrypoints
+
+- Create / start: `{skill-root}/steps-c/step-01-init.md`
+- Continue existing progress: `{skill-root}/steps-c/step-01b-continue.md`
+- Validate the workflow: `{skill-root}/steps-v/step-v-01-validate.md`
+- Edit the workflow: `{skill-root}/steps-e/step-e-01-assess-workflow.md`
+
+### 7 Sessions
+
+1. **Quick Start (30 min)** - TEA Lite intro, run automate workflow
+2. **Core Concepts (45 min)** - Risk-based testing, DoD, philosophy
+3. **Architecture (60 min)** - Fixtures, network patterns, framework
+4. **Test Design (60 min)** - Risk assessment workflow
+5. **ATDD & Automate (60 min)** - ATDD + Automate workflows
+6. **Quality & Trace (45 min)** - Test review + Trace workflows
+7. **Advanced Patterns (ongoing)** - Menu-driven knowledge fragment exploration
+
+### Non-Linear Learning
+
+- Jump to any session based on your experience level
+- Beginners: Start at Session 1
+- Intermediate: Skip to Session 3-6
+- Experienced: Jump to Session 7 (Advanced)
+
+### Session Flow
+
+Each session follows this pattern:
+
+1. Load relevant TEA docs just-in-time
+2. Present teaching content (mostly autonomous)
+3. Knowledge validation quiz (interactive)
+4. Generate session notes artifact
+5. Update progress file
+6. Return to session menu (continue or exit)
+
+## Progress Tracking
+
+Your progress is automatically saved after each session:
+
+- **Progress file:** `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
+- **Session notes:** `{test_artifacts}/tea-academy/{your-name}/session-{N}-notes.md`
+- **Completion Summary:** `{test_artifacts}/tea-academy/{your-name}/tea-completion-summary.md`
+
+## Quiz Scoring
+
+- **Passing threshold:** ≥70%
+- **On failure:** Option to review content or continue anyway
+- **Attempts:** 3 attempts per question before showing correct answer
+
+## Completion
+
+Complete all 7 sessions to receive your TEA Academy completion summary with:
+
+- Session completion dates and scores
+- Skills acquired checklist
+- Learning artifacts paths
+- Recommended next steps
+
+## Tips for Success
+
+1. **Set aside dedicated time** - Each session requires focus (30-90 min)
+2. **Take notes** - Session notes are generated, but add your own insights
+3. **Apply immediately** - Practice concepts on your current project
+4. **Explore fragments** - Session 7 has 59 knowledge fragments to deep-dive
+5. **Share with team** - Help others learn by sharing your experience
+
+## Customization by Role
+
+The workflow adapts examples based on your role:
+
+- **QA:** Practical testing focus, workflow usage
+- **Dev:** Integration perspective, TDD approach
+- **Lead:** Architecture decisions, team patterns
+- **VP:** Strategy, ROI, quality metrics
+
+## Troubleshooting
+
+### Progress file corrupted
+
+- Workflow detects corruption and offers fresh start
+- Backup file created automatically
+
+### Missing TEA docs
+
+- Workflow uses Web-Browsing fallback for external frameworks
+- Primary source is always local docs
+
+### Session interrupted
+
+- Progress auto-saved after quiz completion
+- Resume from session menu on next run
+
+## Support
+
+- **Documentation:** <https://cordya-ai.github.io/froid-plane-test-architecture-enterprise/>
+- **Knowledge Fragments:** <https://github.com/cordya-ai/froid-plane-test-architecture-enterprise/tree/main/src/agents/froid-tea/resources/knowledge>
+- **Issues:** Report via TEA module repository