bmad-method-test-architecture-enterprise 0.1.1-beta.0

package/docs/how-to/workflows/setup-test-framework.md

@@ -0,0 +1,99 @@
+---
+title: 'How to Set Up a Test Framework with TEA'
+description: How to set up a production-ready test framework using TEA
+---
+
+Use TEA's `framework` workflow to scaffold a production-ready test framework for your project.
+
+## When to Use This
+
+- No existing test framework in your project
+- Current test setup isn't production-ready
+- Starting a new project that needs testing infrastructure
+- Phase 3 (Solutioning) after architecture is complete
+
+:::note[Prerequisites]
+
+- BMad Method installed
+- Architecture completed (or at least tech stack decided)
+- TEA agent available
+  :::
+
+## Steps
+
+### 1. Load the TEA Agent
+
+Start a fresh chat and load the TEA (Test Architect) agent.
+
+### 2. Run the Framework Workflow
+
+```
+framework
+```
+
+### 3. Answer TEA's Questions
+
+TEA will ask about:
+
+- Your tech stack (React, Node, etc.)
+- Preferred test framework (Playwright, Cypress, Jest)
+- Testing scope (E2E, integration, unit)
+- CI/CD platform (GitHub Actions, etc.)
+
+### 4. Review Generated Output
+
+TEA generates:
+
+- **Test scaffold** — Directory structure and config files
+- **Sample specs** — Example tests following best practices
+- **`.env.example`** — Environment variable template
+- **`.nvmrc`** — Node version specification
+- **README updates** — Testing documentation
+
+## What You Get
+
+```
+tests/
+├── e2e/
+│   ├── example.spec.ts
+│   └── fixtures/
+├── integration/
+├── unit/
+├── playwright.config.ts  # or cypress.config.ts
+└── README.md
+```
+
+## Optional: Playwright Utils Integration
+
+TEA can integrate with `@seontechnologies/playwright-utils` for advanced fixtures:
+
+```bash
+npm install -D @seontechnologies/playwright-utils
+```
+
+Enable during BMad installation or set `tea_use_playwright_utils: true` in config.
+
+**Utilities available:** api-request, network-recorder, auth-session, intercept-network-call, recurse, log, file-utils, burn-in, network-error-monitor
+
+## Optional: MCP Enhancements
+
+TEA can use Playwright MCP servers for enhanced capabilities:
+
+- `playwright` — Browser automation
+- `playwright-test` — Test runner with failure analysis
+
+Configure in your IDE's MCP settings.
+
+## Tips
+
+- **Run only once per repository** — Framework setup is a one-time operation
+- **Run after architecture is complete** — Framework aligns with tech stack
+- **Follow up with CI setup** — Run `ci` to configure CI/CD pipeline
+
+## Next Steps
+
+After test framework setup:
+
+1. **Test Design** — Create test plans for system or epics
+2. **CI Configuration** — Set up automated test runs
+3. **Story Implementation** — Tests are ready for development

package/docs/index.md

@@ -0,0 +1,122 @@
+---
+title: Test Architect (TEA)
+description: Risk-based test strategy, automation guidance, and release gate decisions for quality-driven development
+template: splash
+hero:
+  title: Test Architect (TEA)
+  tagline: Risk-based test strategy, automation guidance, and release gate decisions for quality-driven development
+  actions:
+    - text: Quick Start
+      link: /tutorials/tea-lite-quickstart/
+      icon: right-arrow
+      variant: primary
+    - text: View on GitHub
+      link: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise
+      icon: external
+---
+
+## What is TEA?
+
+TEA (Test Architect) is a standalone BMAD module that delivers expert test architecture guidance through 8 comprehensive workflows. It provides risk-based test strategy, automation planning, and measurable quality gates for software projects of any size.
+
+## Why TEA?
+
+- **Risk-Based Testing**: P0-P3 prioritization based on probability and impact
+- **Consistent Outputs**: Knowledge-base driven guidance ensures standardized results
+- **Measurable Quality**: Objective scoring (0-100) for test coverage and quality
+- **Release Gates**: Go/No-Go decisions backed by requirements traceability
+- **Framework Agnostic**: Works with Playwright, Cypress, and other test frameworks
+
+## Core Workflows
+
+| Workflow                                                  | Trigger | Purpose                                |
+| --------------------------------------------------------- | ------- | -------------------------------------- |
+| [Framework Setup](/how-to/workflows/setup-test-framework) | TF      | Scaffold test framework                |
+| [CI/CD Integration](/how-to/workflows/setup-ci)           | CI      | Set up quality pipeline                |
+| [Test Design](/how-to/workflows/run-test-design)          | TD      | Risk-based test planning               |
+| [ATDD](/how-to/workflows/run-atdd)                        | AT      | Failing acceptance tests (TDD)         |
+| [Test Automation](/how-to/workflows/run-automate)         | TA      | Expand automation coverage             |
+| [Test Review](/how-to/workflows/run-test-review)          | RV      | Quality audit with scoring             |
+| [Requirements Tracing](/how-to/workflows/run-trace)       | TR      | Coverage mapping + gate decision       |
+| [NFR Assessment](/how-to/workflows/run-nfr-assess)        | NR      | Non-functional requirements evaluation |
+
+## Getting Started
+
+Choose your engagement model:
+
+- **TEA Lite**: Start with [Test Automation](/how-to/workflows/run-automate) only (30 minutes)
+- **Full TEA**: Complete [Quick Start Tutorial](/tutorials/tea-lite-quickstart) (1-2 hours)
+- **Enterprise**: Integrate all 8 workflows into your development process
+
+## Quick Install
+
+```bash
+npx bmad-method install
+# Select: Test Architect (TEA)
+```
+
+Then trigger workflows via chat:
+
+```
+tea              # Load TEA agent
+test-design      # Run Test Design workflow
+```
+
+## Learn More
+
+<div class="sl-flex">
+  <a href="/tutorials/tea-lite-quickstart/" class="action primary">
+    Quick Start Tutorial →
+  </a>
+  <a href="/explanation/tea-overview/" class="action secondary">
+    How TEA Works →
+  </a>
+</div>
+
+## Key Features
+
+### 🎯 Risk-Based Testing
+
+TEA evaluates test priorities using a probability × impact matrix, focusing effort where it matters most.
+
+### 📚 Knowledge Base System
+
+34 curated testing patterns loaded dynamically per workflow ensure consistent, high-quality outputs.
+
+### ⚡ Subprocess Architecture
+
+Parallel test generation for API and E2E tests speeds up workflow execution while maintaining quality.
+
+### 📊 Measurable Quality
+
+Objective 0-100 scoring across 5 quality dimensions: Determinism, Isolation, Maintainability, Coverage, Performance.
+
+### 🚪 Release Gates
+
+Requirements traceability with automated gap analysis provides clear Go/No-Go recommendations.
+
+## Engagement Models
+
+- **No TEA**: Continue with your existing testing approach
+- **TEA Solo**: Use TEA standalone on non-BMAD projects
+- **TEA Lite**: Fast onboarding with Test Automation workflow only
+- **Integrated**: Full TEA integration with BMAD Method (Phases 3-4)
+- **Enterprise**: Complete quality governance with all 8 workflows
+
+## Documentation Structure
+
+- **[Tutorials](/tutorials/tea-lite-quickstart)**: Learn TEA step-by-step
+- **[How-To Guides](/how-to/workflows/run-test-design)**: Task-focused instructions
+- **[Explanation](/explanation/tea-overview)**: Understand concepts and architecture
+- **[Reference](/reference/commands)**: Commands, configuration, knowledge base
+- **[Glossary](/glossary)**: Terminology and definitions
+
+## Support
+
+- **Documentation**: [test-architect.bmad-method.org](https://test-architect.bmad-method.org)
+- **Issues**: [GitHub Issues](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/discussions)
+
+---
+
+Ready to improve your test architecture? Start with the [Quick Start Tutorial](/tutorials/tea-lite-quickstart).

package/docs/reference/commands.md

@@ -0,0 +1,300 @@
+---
+title: 'TEA Command Reference'
+description: Quick reference for all 8 TEA workflows - inputs, outputs, and links to detailed guides
+---
+
+# TEA Command Reference
+
+Quick reference for all 8 TEA (Test Architect) workflows. For detailed step-by-step guides, see the how-to documentation.
+
+## Quick Index
+
+- [`framework`](#framework) - Scaffold test framework
+- [`ci`](#ci) - Setup CI/CD pipeline
+- [`test-design`](#test-design) - Risk-based test planning
+- [`atdd`](#atdd) - Acceptance TDD
+- [`automate`](#automate) - Test automation
+- [`test-review`](#test-review) - Quality audit
+- [`nfr-assess`](#nfr-assess) - NFR assessment
+- [`trace`](#trace) - Coverage traceability
+
+---
+
+## framework
+
+**Purpose:** Scaffold production-ready test framework (Playwright or Cypress)
+
+**Phase:** Phase 3 (Solutioning)
+
+**Frequency:** Once per project
+
+**Key Inputs:**
+
+- Tech stack, test framework choice, testing scope
+
+**Key Outputs:**
+
+- `tests/` directory with `support/fixtures/` and `support/helpers/`
+- `playwright.config.ts` or `cypress.config.ts`
+- `.env.example`, `.nvmrc`
+- Sample tests with best practices
+
+**How-To Guide:** [Setup Test Framework](/docs/how-to/workflows/setup-test-framework.md)
+
+---
+
+## ci
+
+**Purpose:** Setup CI/CD pipeline with selective testing and burn-in
+
+**Phase:** Phase 3 (Solutioning)
+
+**Frequency:** Once per project
+
+**Key Inputs:**
+
+- CI platform (GitHub Actions, GitLab CI, etc.)
+- Sharding strategy, burn-in preferences
+
+**Key Outputs:**
+
+- Platform-specific CI workflow (`.github/workflows/test.yml`, etc.)
+- Parallel execution configuration
+- Burn-in loops for flakiness detection
+- Secrets checklist
+
+**How-To Guide:** [Setup CI Pipeline](/docs/how-to/workflows/setup-ci.md)
+
+---
+
+## test-design
+
+**Purpose:** Risk-based test planning with coverage strategy
+
+**Phase:** Phase 3 (system-level), Phase 4 (epic-level)
+
+**Frequency:** Once (system), per epic (epic-level)
+
+**Modes:**
+
+- **System-level:** Architecture testability review (TWO documents)
+- **Epic-level:** Per-epic risk assessment (ONE document)
+
+**Key Inputs:**
+
+- System-level: Architecture, PRD, ADRs
+- Epic-level: Epic, stories, acceptance criteria
+
+**Key Outputs:**
+
+**System-Level (TWO Documents):**
+
+- `test-design-architecture.md` - For Architecture/Dev teams
+  - Quick Guide (🚨 BLOCKERS / ⚠️ HIGH PRIORITY / 📋 INFO ONLY)
+  - Risk assessment with scoring
+  - Testability concerns and gaps
+  - Mitigation plans
+- `test-design-qa.md` - For QA team
+  - Test execution recipe
+  - Coverage plan (P0/P1/P2/P3 with checkboxes)
+  - Sprint 0 setup requirements
+  - NFR readiness summary
+
+**Epic-Level (ONE Document):**
+
+- `test-design-epic-N.md`
+  - Risk assessment (probability × impact scores)
+  - Test priorities (P0-P3)
+  - Coverage strategy
+  - Mitigation plans
+
+**Why Two Documents for System-Level?**
+
+- Architecture teams scan blockers in <5 min
+- QA teams have actionable test recipes
+- No redundancy (cross-references instead)
+- Clear separation (what to deliver vs how to test)
+
+**MCP Enhancement:** Exploratory mode (live browser UI discovery)
+
+**How-To Guide:** [Run Test Design](/docs/how-to/workflows/run-test-design.md)
+
+---
+
+## atdd
+
+**Purpose:** Generate failing acceptance tests BEFORE implementation (TDD red phase)
+
+**Phase:** Phase 4 (Implementation)
+
+**Frequency:** Per story (optional)
+
+**Key Inputs:**
+
+- Story with acceptance criteria, test design, test levels
+
+**Key Outputs:**
+
+- Failing tests (`tests/api/`, `tests/e2e/`)
+- Implementation checklist
+- All tests fail initially (red phase)
+
+**MCP Enhancement:** Recording mode (for skeleton UI only - rare)
+
+**How-To Guide:** [Run ATDD](/docs/how-to/workflows/run-atdd.md)
+
+---
+
+## automate
+
+**Purpose:** Expand test coverage after implementation
+
+**Phase:** Phase 4 (Implementation)
+
+**Frequency:** Per story/feature
+
+**Key Inputs:**
+
+- Feature description, test design, existing tests to avoid duplication
+
+**Key Outputs:**
+
+- Comprehensive test suite (`tests/e2e/`, `tests/api/`)
+- Updated fixtures, README
+- Definition of Done summary
+
+**MCP Enhancement:** Healing + Recording modes (fix tests, verify selectors)
+
+**How-To Guide:** [Run Automate](/docs/how-to/workflows/run-automate.md)
+
+---
+
+## test-review
+
+**Purpose:** Audit test quality with 0-100 scoring
+
+**Phase:** Phase 4 (optional per story), Release Gate
+
+**Frequency:** Per epic or before release
+
+**Key Inputs:**
+
+- Test scope (file, directory, or entire suite)
+
+**Key Outputs:**
+
+- `test-review.md` with quality score (0-100)
+- Critical issues with fixes
+- Recommendations
+- Category scores (Determinism, Isolation, Assertions, Structure, Performance)
+
+**Scoring Categories:**
+
+- Determinism: 35 points
+- Isolation: 25 points
+- Assertions: 20 points
+- Structure: 10 points
+- Performance: 10 points
+
+**How-To Guide:** [Run Test Review](/docs/how-to/workflows/run-test-review.md)
+
+---
+
+## nfr-assess
+
+**Purpose:** Validate non-functional requirements with evidence
+
+**Phase:** Phase 2 (enterprise), Release Gate
+
+**Frequency:** Per release (enterprise projects)
+
+**Key Inputs:**
+
+- NFR categories (Security, Performance, Reliability, Maintainability)
+- Thresholds, evidence location
+
+**Key Outputs:**
+
+- `nfr-assessment.md`
+- Category assessments (PASS/CONCERNS/FAIL)
+- Mitigation plans
+- Gate decision inputs
+
+**How-To Guide:** [Run NFR Assessment](/docs/how-to/workflows/run-nfr-assess.md)
+
+---
+
+## trace
+
+**Purpose:** Requirements traceability + quality gate decision
+
+**Phase:** Phase 2/4 (traceability), Release Gate (decision)
+
+**Frequency:** Baseline, per epic refresh, release gate
+
+**Two-Phase Workflow:**
+
+**Phase 1: Traceability**
+
+- Requirements → test mapping
+- Coverage classification (FULL/PARTIAL/NONE)
+- Gap prioritization
+- Output: `traceability-matrix.md`
+
+**Phase 2: Gate Decision**
+
+- PASS/CONCERNS/FAIL/WAIVED decision
+- Evidence-based (coverage %, quality scores, NFRs)
+- Output: `gate-decision-{gate_type}-{story_id}.md`
+
+**Gate Rules:**
+
+- P0 coverage: 100% required
+- P1 coverage: ≥90% for PASS, 80-89% for CONCERNS, <80% FAIL
+- Overall coverage: ≥80% required
+
+**How-To Guide:** [Run Trace](/docs/how-to/workflows/run-trace.md)
+
+---
+
+## Summary Table
+
+| Command       | Phase      | Frequency                 | Primary Output             |
+| ------------- | ---------- | ------------------------- | -------------------------- |
+| `framework`   | 3          | Once                      | Test infrastructure        |
+| `ci`          | 3          | Once                      | CI/CD pipeline             |
+| `test-design` | 3, 4       | System + per epic         | Test design doc            |
+| `atdd`        | 4          | Per story (optional)      | Failing tests              |
+| `automate`    | 4          | Per story                 | Passing tests              |
+| `test-review` | 4, Gate    | Per epic/release          | Quality report             |
+| `nfr-assess`  | 2, Gate    | Per release               | NFR assessment             |
+| `trace`       | 2, 4, Gate | Baseline + refresh + gate | Coverage matrix + decision |
+
+---
+
+## See Also
+
+**How-To Guides (Detailed Instructions):**
+
+- [Setup Test Framework](/docs/how-to/workflows/setup-test-framework.md)
+- [Setup CI Pipeline](/docs/how-to/workflows/setup-ci.md)
+- [Run Test Design](/docs/how-to/workflows/run-test-design.md)
+- [Run ATDD](/docs/how-to/workflows/run-atdd.md)
+- [Run Automate](/docs/how-to/workflows/run-automate.md)
+- [Run Test Review](/docs/how-to/workflows/run-test-review.md)
+- [Run NFR Assessment](/docs/how-to/workflows/run-nfr-assess.md)
+- [Run Trace](/docs/how-to/workflows/run-trace.md)
+
+**Explanation:**
+
+- [TEA Overview](/docs/explanation/tea-overview.md) - Complete TEA lifecycle
+- [Engagement Models](/docs/explanation/engagement-models.md) - When to use which workflows
+
+**Reference:**
+
+- [TEA Configuration](/docs/reference/configuration.md) - Config options
+- [Knowledge Base Index](/docs/reference/knowledge-base.md) - Pattern fragments
+
+---
+
+Generated with [BMad Method](https://bmad-method.org) - TEA (Test Architect)