# vinayshetyeofficial/agentic-ai-e2e-qa-workflow architecture

> Architecture diagram of the GitHub repository vinayshetyeofficial/agentic-ai-e2e-qa-workflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow
- Repository: https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow

## Overview

This repository demonstrates a documented AI-assisted QA workflow: checkout requirements are planned, explored, automated, executed, healed if needed, reported, and prepared for deployment. The agent definitions, test plan, tests, and results are repository artifacts; the README describes their workflow relationships. The supervisor and some stages are documented capabilities rather than sampled implementations, so links below reflect README claims, not verified runtime calls.

Main entry points: [`playwright.config.ts`](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/playwright.config.ts) (Playwright Execution), [`.github/agents`](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/tree/main/.github/agents) (QA Supervisor), [`.github/agents/playwright-test-planner.agent.md`](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-planner.agent.md) (Test Planner), [`.github/agents/playwright-test-generator.agent.md`](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-generator.agent.md) (Test Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Requirements & Planning"]
  node_story["Checkout Story"]
  node_plan["Checkout Test Plan"]
  node_exploration["Exploration Results"]
end

subgraph group_agents["AI QA Agents"]
  node_planner["Test Planner"]
  node_supervisor["QA Supervisor<br/>[agents]"]
  node_generator["Test Generator"]
  node_healer["Test Healer"]
end

subgraph group_automation["Playwright Automation"]
  node_auth["Authentication Setup<br/>[auth.setup.ts]"]
  node_checkout_tests["Checkout Test Suite"]
  node_playwright["Playwright Execution"]
end

subgraph group_outcomes["Execution &amp; Outcomes"]
  node_report["Test Report"]
  node_deployment["CI/CD Readiness<br/>[playwright.yml]"]
end

node_qa_user(("QA Engineer"))

node_qa_user -->|"provides requirements"| node_story
node_story -->|"analyzes story"| node_planner
node_planner -->|"creates scenarios"| node_plan
node_plan -->|"guides exploration"| node_exploration
node_exploration -->|"informs automation"| node_generator
node_supervisor -->|"orchestrates"| node_planner
node_supervisor -->|"orchestrates"| node_generator
node_supervisor -->|"orchestrates"| node_healer
node_generator -->|"generates scripts"| node_checkout_tests
node_auth -.->|"supports authentication"| node_checkout_tests
node_checkout_tests -->|"runs in"| node_playwright
node_playwright -->|"provides failures"| node_healer
node_healer -->|"reruns tests"| node_playwright
node_playwright -->|"produces results"| node_report
node_report -->|"supports readiness"| node_deployment

click node_story "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/user-stories/SCRUM-101-ecommerce-checkout.md"
click node_planner "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-planner.agent.md"
click node_plan "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/specs/saucedemo-checkout-test-plan.md"
click node_exploration "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/exploratory-test-results.md"
click node_supervisor "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/tree/main/.github/agents"
click node_generator "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-generator.agent.md"
click node_auth "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/tests/saucedemo-checkout/auth.setup.ts"
click node_checkout_tests "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/tree/main/tests/saucedemo-checkout"
click node_healer "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-healer.agent.md"
click node_playwright "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/playwright.config.ts"
click node_report "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/test-results/SCRUM-101-checkout-test-report.md"
click node_deployment "https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/workflows/playwright.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_story,node_plan,node_exploration toneBlue
class node_planner,node_supervisor,node_generator,node_healer toneAmber
class node_auth,node_checkout_tests,node_playwright toneMint
class node_report,node_deployment toneRose
class node_qa_user toneIndigo
```

## Components

### Requirements & Planning

- [Checkout Story](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/user-stories/SCRUM-101-ecommerce-checkout.md): `user-stories/SCRUM-101-ecommerce-checkout.md`
- [Checkout Test Plan](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/specs/saucedemo-checkout-test-plan.md): `specs/saucedemo-checkout-test-plan.md`
- [Exploration Results](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/exploratory-test-results.md): `exploratory-test-results.md`

### AI QA Agents

- [Test Planner](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-planner.agent.md): `.github/agents/playwright-test-planner.agent.md`
- [QA Supervisor](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/tree/main/.github/agents): `.github/agents`
- [Test Generator](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-generator.agent.md): `.github/agents/playwright-test-generator.agent.md`
- [Test Healer](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/agents/playwright-test-healer.agent.md): `.github/agents/playwright-test-healer.agent.md`

### Playwright Automation

- [Authentication Setup](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/tests/saucedemo-checkout/auth.setup.ts): `tests/saucedemo-checkout/auth.setup.ts`
- [Checkout Test Suite](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/tree/main/tests/saucedemo-checkout): `tests/saucedemo-checkout`
- [Playwright Execution](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/playwright.config.ts): `playwright.config.ts`

### Execution & Outcomes

- [Test Report](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/test-results/SCRUM-101-checkout-test-report.md): `test-results/SCRUM-101-checkout-test-report.md`
- [CI/CD Readiness](https://github.com/vinayshetyeofficial/agentic-ai-e2e-qa-workflow/blob/main/.github/workflows/playwright.yml): `.github/workflows/playwright.yml`

### Other components

- **QA Engineer**

## Connections

- QA Engineer → Checkout Story: provides requirements (evidence: `README.md`)
- Checkout Story → Test Planner: analyzes story (evidence: `README.md`)
- Test Planner → Checkout Test Plan: creates scenarios (evidence: `README.md`)
- Checkout Test Plan → Exploration Results: guides exploration (evidence: `README.md`)
- Exploration Results → Test Generator: informs automation (evidence: `README.md`)
- QA Supervisor → Test Planner: orchestrates (evidence: `README.md`)
- QA Supervisor → Test Generator: orchestrates (evidence: `README.md`)
- QA Supervisor → Test Healer: orchestrates (evidence: `README.md`)
- Test Generator → Checkout Test Suite: generates scripts (evidence: `README.md`)
- Authentication Setup → Checkout Test Suite: supports authentication
- Checkout Test Suite → Playwright Execution: runs in (evidence: `README.md`)
- Playwright Execution → Test Healer: provides failures (evidence: `README.md`)
- Test Healer → Playwright Execution: reruns tests (evidence: `README.md`)
- Playwright Execution → Test Report: produces results (evidence: `README.md`)
- Test Report → CI/CD Readiness: supports readiness (evidence: `README.md`)