diff --git a/src/modules/bmm/docs/test-architecture.md b/src/modules/bmm/docs/test-architecture.md
index 76b75bf3..52527931 100644
--- a/src/modules/bmm/docs/test-architecture.md
+++ b/src/modules/bmm/docs/test-architecture.md
@@ -26,14 +26,17 @@ graph TB
subgraph Phase3["Phase 3: SOLUTIONING"]
Architecture["Architect: *architecture"]
EpicsStories["PM/Architect: *create-epics-and-stories"]
+ TestDesignSys["TEA: *test-design (system-level)"]
Framework["TEA: *framework"]
CI["TEA: *ci"]
GateCheck["Architect: *implementation-readiness"]
Architecture --> EpicsStories
+ Architecture --> TestDesignSys
+ TestDesignSys --> Framework
EpicsStories --> Framework
Framework --> CI
CI --> GateCheck
- Phase3Note["Epics created AFTER architecture,
then test infrastructure setup"]
+ Phase3Note["Epics created AFTER architecture,
then system-level test design and test infra setup"]
EpicsStories -.-> Phase3Note
end
@@ -96,9 +99,12 @@ graph TB
- **Phase 3** (Track-dependent): Solutioning (`*architecture` → `*create-epics-and-stories` → TEA: `*framework`, `*ci` → `*implementation-readiness`)
- **Phase 4** (Required): Implementation (`*sprint-planning` → per-epic: `*test-design` → per-story: dev workflows)
-**TEA workflows:** `*framework` and `*ci` run once in Phase 3 after architecture. `*test-design` runs per-epic in Phase 4. Output: `test-design-epic-N.md`.
+**TEA workflows:** `*framework` and `*ci` run once in Phase 3 after architecture. `*test-design` is **dual-mode**:
-Quick Flow track skips Phase 1 and 3. BMad Method and Enterprise use all phases based on project needs.
+- **System-level (Phase 3):** Run immediately after architecture/ADR drafting to produce `test-design-system.md` (testability review, ADR → test mapping, ASRs, environment needs). Feeds the implementation-readiness gate.
+- **Epic-level (Phase 4):** Run per-epic to produce `test-design-epic-N.md` (risk, priorities, coverage plan).
+
+Quick Flow track skips Phase 1 and 3. BMad Method and Enterprise use all phases based on project needs. When an ADR/architecture draft is produced, run `*test-design` in **system-level** mode before the implementation-readiness gate so the ADR has an attached testability review and ADR → test mapping; keep it updated if ADRs change.
### Why TEA is Different from Other BMM Agents