Skip to content

Commit 66e7d3a

Browse files
docs: tea in 4; Diátaxis (#1320)
* docs: tea in 4; Diátaxis * docs: addressed review comments * docs: refined the docs
1 parent 2b7f7ff commit 66e7d3a

23 files changed

Lines changed: 12271 additions & 93 deletions

docs/explanation/features/tea-overview.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,16 @@ BMad does not mandate TEA. There are five valid ways to use it (or skip it). Pic
2323
1. **No TEA**
2424
- Skip all TEA workflows. Use your existing team testing approach.
2525

26-
2. **TEA-only (Standalone)**
26+
2. **TEA Solo (Standalone)**
2727
- Use TEA on a non-BMad project. Bring your own requirements, acceptance criteria, and environments.
2828
- Typical sequence: `*test-design` (system or epic) -> `*atdd` and/or `*automate` -> optional `*test-review` -> `*trace` for coverage and gate decisions.
2929
- Run `*framework` or `*ci` only if you want TEA to scaffold the harness or pipeline; they work best after you decide the stack/architecture.
3030

31+
**TEA Lite (Beginner Approach):**
32+
- Simplest way to use TEA - just use `*automate` to test existing features.
33+
- Perfect for learning TEA fundamentals in 30 minutes.
34+
- See [TEA Lite Quickstart Tutorial](/docs/tutorials/getting-started/tea-lite-quickstart.md).
35+
3136
3. **Integrated: Greenfield - BMad Method (Simple/Standard Work)**
3237
- Phase 3: system-level `*test-design`, then `*framework` and `*ci`.
3338
- Phase 4: per-epic `*test-design`, optional `*atdd`, then `*automate` and optional `*test-review`.
@@ -55,8 +60,8 @@ If you are unsure, default to the integrated path for your track and adjust late
5560
| `*framework` | Playwright/Cypress scaffold, `.env.example`, `.nvmrc`, sample specs | Use when no production-ready harness exists | - |
5661
| `*ci` | CI workflow, selective test scripts, secrets checklist | Platform-aware (GitHub Actions default) | - |
5762
| `*test-design` | Combined risk assessment, mitigation plan, and coverage strategy | Risk scoring + optional exploratory mode | **+ Exploratory**: Interactive UI discovery with browser automation (uncover actual functionality) |
58-
| `*atdd` | Failing acceptance tests + implementation checklist | TDD red phase + optional recording mode | **+ Recording**: AI generation verified with live browser (accurate selectors from real DOM) |
59-
| `*automate` | Prioritized specs, fixtures, README/script updates, DoD summary | Optional healing/recording, avoid duplicate coverage | **+ Healing**: Pattern fixes enhanced with visual debugging + **+ Recording**: AI verified with live browser |
63+
| `*atdd` | Failing acceptance tests + implementation checklist | TDD red phase + optional recording mode | **+ Recording**: UI selectors verified with live browser; API tests benefit from trace analysis |
64+
| `*automate` | Prioritized specs, fixtures, README/script updates, DoD summary | Optional healing/recording, avoid duplicate coverage | **+ Healing**: Visual debugging + trace analysis for test fixes; **+ Recording**: Verified selectors (UI) + network inspection (API) |
6065
| `*test-review` | Test quality review report with 0-100 score, violations, fixes | Reviews tests against knowledge base patterns | - |
6166
| `*nfr-assess` | NFR assessment report with actions | Focus on security/performance/reliability | - |
6267
| `*trace` | Phase 1: Coverage matrix, recommendations. Phase 2: Gate decision (PASS/CONCERNS/FAIL/WAIVED) | Two-phase workflow: traceability + gate decision | - |
@@ -279,6 +284,31 @@ These cheat sheets map TEA workflows to the **BMad Method and Enterprise tracks*
279284
**Related how-to guides:**
280285
- [How to Run Test Design](/docs/how-to/workflows/run-test-design.md)
281286
- [How to Set Up a Test Framework](/docs/how-to/workflows/setup-test-framework.md)
287+
- [How to Run ATDD](/docs/how-to/workflows/run-atdd.md)
288+
- [How to Run Automate](/docs/how-to/workflows/run-automate.md)
289+
- [How to Run Test Review](/docs/how-to/workflows/run-test-review.md)
290+
- [How to Set Up CI Pipeline](/docs/how-to/workflows/setup-ci.md)
291+
- [How to Run NFR Assessment](/docs/how-to/workflows/run-nfr-assess.md)
292+
- [How to Run Trace](/docs/how-to/workflows/run-trace.md)
293+
294+
## Deep Dive Concepts
295+
296+
Want to understand TEA principles and patterns in depth?
297+
298+
**Core Principles:**
299+
- [Risk-Based Testing](/docs/explanation/tea/risk-based-testing.md) - Probability × impact scoring, P0-P3 priorities
300+
- [Test Quality Standards](/docs/explanation/tea/test-quality-standards.md) - Definition of Done, determinism, isolation
301+
- [Knowledge Base System](/docs/explanation/tea/knowledge-base-system.md) - Context engineering with tea-index.csv
302+
303+
**Technical Patterns:**
304+
- [Fixture Architecture](/docs/explanation/tea/fixture-architecture.md) - Pure function → fixture → composition
305+
- [Network-First Patterns](/docs/explanation/tea/network-first-patterns.md) - Eliminating flakiness with intercept-before-navigate
306+
307+
**Engagement & Strategy:**
308+
- [Engagement Models](/docs/explanation/tea/engagement-models.md) - TEA Lite, TEA Solo, TEA Integrated (5 models explained)
309+
310+
**Philosophy:**
311+
- [Testing as Engineering](/docs/explanation/philosophy/testing-as-engineering.md) - **Start here to understand WHY TEA exists** - The problem with AI-generated tests and TEA's three-part solution
282312

283313
## Optional Integrations
284314

0 commit comments

Comments
 (0)