CollectFlow/_bmad/tea/workflows/testarch/test-design/steps-c/step-02-load-context.md

name, description, nextStepFile, knowledgeIndex, outputFile

name	description	nextStepFile	knowledgeIndex	outputFile
step-02-load-context	Load documents, configuration, and knowledge fragments for the chosen mode	./step-03-risk-and-testability.md	{project-root}/_bmad/tea/testarch/tea-index.csv	{test_artifacts}/test-design-progress.md

Step 2: Load Context & Knowledge Base

STEP GOAL

Load the required documents, config flags, and knowledge fragments needed to produce accurate test design outputs.

MANDATORY EXECUTION RULES

• 📖 Read the entire step file before acting
• ✅ Speak in {communication_language}
• 🎯 Only load artifacts required for the selected mode

---

EXECUTION PROTOCOLS:

• 🎯 Follow the MANDATORY SEQUENCE exactly
• 💾 Record outputs before proceeding
• 📖 Load the next step only when instructed

CONTEXT BOUNDARIES:

• Available context: config, loaded artifacts, and knowledge fragments
• Focus: this step's goal only
• Limits: do not execute future steps
• Dependencies: prior steps' outputs (if any)

MANDATORY SEQUENCE

CRITICAL: Follow this sequence exactly. Do not skip, reorder, or improvise.

1. Load Configuration

From {config_source}:

• Read tea_use_playwright_utils
• Read tea_browser_automation
• Note test_artifacts

---

2. Load Project Artifacts (Mode-Specific)

System-Level Mode (Phase 3)

Load:

• PRD (FRs + NFRs)
• ADRs or architecture decisions
• Architecture / tech-spec document
• Epics (for scope)

Extract:

• Tech stack & dependencies
• Integration points
• NFRs (performance, security, reliability, compliance)

Epic-Level Mode (Phase 4)

Load:

• Epic and story docs with acceptance criteria
• PRD (if available)
• Architecture / tech-spec (if available)
• Prior system-level test-design outputs (if available)

Extract:

• Testable requirements
• Integration points
• Known coverage gaps

---

3. Analyze Existing Test Coverage (Epic-Level)

If epic-level:

• Scan the repository for existing tests (search for tests/, spec, e2e, api folders)
• Identify coverage gaps and flaky areas
• Note existing fixture and test patterns

Browser Exploration (if tea_browser_automation is cli or auto)

Fallback: If CLI is not installed, fall back to MCP (if available) or skip browser exploration and rely on code/doc analysis.

CLI Exploration Steps: All commands use the same named session to target the correct browser:

1. playwright-cli -s=tea-explore open <target_url>
2. playwright-cli -s=tea-explore snapshot → capture page structure and element refs
3. playwright-cli -s=tea-explore screenshot --filename={test_artifacts}/exploration/explore-<page>.png
4. Analyze snapshot output to identify testable elements and flows
5. playwright-cli -s=tea-explore close

Store artifacts under {test_artifacts}/exploration/

Session Hygiene: Always close sessions using playwright-cli -s=tea-explore close. Do NOT use close-all — it kills every session on the machine and breaks parallel execution.

---

4. Load Knowledge Base Fragments

Use {knowledgeIndex} to select and load only relevant fragments.

System-Level Mode (Required)

• adr-quality-readiness-checklist.md
• test-levels-framework.md
• risk-governance.md
• test-quality.md

Epic-Level Mode (Required)

• risk-governance.md
• probability-impact.md
• test-levels-framework.md
• test-priorities-matrix.md

Playwright CLI (if tea_browser_automation is "cli" or "auto"):

• playwright-cli.md

MCP Patterns (if tea_browser_automation is "mcp" or "auto"):

• (existing MCP-related fragments, if any are added in future)

---

5. Confirm Loaded Inputs

Summarize what was loaded and confirm with the user if anything is missing.

---

6. Save Progress

Save this step's accumulated work to {outputFile}.

• If {outputFile} does not exist (first save), create it with YAML frontmatter:

  ---
  stepsCompleted: ['step-02-load-context']
  lastStep: 'step-02-load-context'
  lastSaved: '{date}'
  ---
  

  Then write this step's output below the frontmatter.

• If {outputFile} already exists, update:

  • Add 'step-02-load-context' to stepsCompleted array (only if not already present)
  • Set lastStep: 'step-02-load-context'
  • Set lastSaved: '{date}'
  • Append this step's output to the appropriate section of the document.

Load next step: {nextStepFile}

🚨 SYSTEM SUCCESS/FAILURE METRICS:

✅ SUCCESS:

• Step completed in full with required outputs

❌ SYSTEM FAILURE:

• Skipped sequence steps or missing outputs Master Rule: Skipping steps is FORBIDDEN.