# nitesh00747/promtdrivenautomation_javascript architecture

> Architecture diagram of the GitHub repository nitesh00747/promtdrivenautomation_javascript, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nitesh00747/promtdrivenautomation_javascript
- Repository: https://github.com/nitesh00747/promtdrivenautomation_javascript

## Overview

This repository demonstrates a prompt-driven Playwright workflow for planning, generating, and healing web-application tests, with SauceDemo as its example target. The principal flow runs from a human request through agent-authored plans and generated tests to suite execution and repair. The graph also preserves the documented shopping-journey coverage and duplicate-coverage manifest. Relationships are based on README statements and the sampled Playwright configuration; individual agent definitions and test implementations were not sampled.

Main entry points: [`tests`](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests) (Generated tests), [`.claude/agents/playwright-test-generator.md`](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-generator.md) (Generator agent), [`playwright.config.js`](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/playwright.config.js) (Playwright runner), [`.claude/agents/playwright-test-planner.md`](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-planner.md) (Planner agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_planner["Planner agent"]
  node_generator["Generator agent"]
  node_healer["Healer agent"]
  node_runner["Playwright runner"]
end

subgraph group_artifacts["Plans and tests"]
  node_plans["Test plans"]
  node_manifest["Coverage manifest<br/>[manifest.json]"]
  node_tests["Generated tests"]
end

subgraph group_coverage["Demo coverage"]
  node_login["Login cases"]
  node_inventory["Inventory cases"]
  node_sorting["Sorting cases"]
  node_detail["Product detail"]
  node_cart["Cart cases"]
  node_checkout["Checkout cases"]
  node_menu["Logout and reset"]
end

node_user(("Engineer"))
node_saucedemo["SauceDemo app"]

node_user -->|"requests plan"| node_planner
node_planner -->|"explores app"| node_saucedemo
node_planner -->|"writes plan"| node_plans
node_user -->|"requests tests"| node_generator
node_generator -->|"reads plan"| node_plans
node_generator -->|"replays steps"| node_saucedemo
node_generator -->|"writes tests"| node_tests
node_user -->|"runs suite"| node_runner
node_runner -->|"discovers tests"| node_tests
node_runner -->|"targets app"| node_saucedemo
node_user -->|"requests repair"| node_healer
node_healer -->|"runs suite"| node_runner
node_healer -->|"repairs tests"| node_tests
node_tests -->|"indexed by"| node_manifest
node_tests -->|"covers"| node_login
node_tests -->|"covers"| node_inventory
node_tests -->|"covers"| node_sorting
node_tests -->|"covers"| node_detail
node_tests -->|"covers"| node_cart
node_tests -->|"covers"| node_checkout
node_tests -->|"covers"| node_menu

click node_planner "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-planner.md"
click node_generator "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-generator.md"
click node_healer "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-healer.md"
click node_plans "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/specs"
click node_manifest "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/specs/manifest.json"
click node_tests "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests"
click node_runner "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/playwright.config.js"
click node_login "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/login"
click node_inventory "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/inventory"
click node_sorting "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/sorting/product-sort.spec.ts"
click node_detail "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/product-detail/product-detail.spec.ts"
click node_cart "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/cart"
click node_checkout "https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/checkout/checkout-flow.spec.ts"
click node_menu "https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/menu"

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_planner,node_generator,node_healer,node_runner toneBlue
class node_plans,node_manifest,node_tests toneAmber
class node_login,node_inventory,node_sorting,node_detail,node_cart,node_checkout,node_menu toneMint
class node_user,node_saucedemo toneIndigo
```

## Components

### Agent workflow

- [Planner agent](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-planner.md): `.claude/agents/playwright-test-planner.md`
- [Generator agent](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-generator.md): `.claude/agents/playwright-test-generator.md`
- [Healer agent](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/.claude/agents/playwright-test-healer.md): `.claude/agents/playwright-test-healer.md`
- [Playwright runner](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/playwright.config.js): `playwright.config.js`

### Plans and tests

- [Test plans](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/specs): `specs`
- [Coverage manifest](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/specs/manifest.json): `specs/manifest.json`
- [Generated tests](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests): `tests`

### Demo coverage

- [Login cases](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/login): `tests/login`
- [Inventory cases](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/inventory): `tests/inventory`
- [Sorting cases](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/sorting/product-sort.spec.ts): `tests/sorting/product-sort.spec.ts`
- [Product detail](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/product-detail/product-detail.spec.ts): `tests/product-detail/product-detail.spec.ts`
- [Cart cases](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/cart): `tests/cart`
- [Checkout cases](https://github.com/nitesh00747/promtdrivenautomation_javascript/blob/master/tests/checkout/checkout-flow.spec.ts): `tests/checkout/checkout-flow.spec.ts`
- [Logout and reset](https://github.com/nitesh00747/promtdrivenautomation_javascript/tree/master/tests/menu): `tests/menu`

### Other components

- **Engineer**
- **SauceDemo app**

## Connections

- Engineer → Planner agent: requests plan (evidence: `README.md`)
- Planner agent → SauceDemo app: explores app (evidence: `README.md`)
- Planner agent → Test plans: writes plan (evidence: `README.md`)
- Engineer → Generator agent: requests tests (evidence: `README.md`)
- Generator agent → Test plans: reads plan (evidence: `README.md`)
- Generator agent → SauceDemo app: replays steps (evidence: `README.md`)
- Generator agent → Generated tests: writes tests (evidence: `README.md`)
- Engineer → Playwright runner: runs suite (evidence: `README.md`)
- Playwright runner → Generated tests: discovers tests (evidence: `playwright.config.js`)
- Playwright runner → SauceDemo app: targets app (evidence: `playwright.config.js`)
- Engineer → Healer agent: requests repair (evidence: `README.md`)
- Healer agent → Playwright runner: runs suite (evidence: `README.md`)
- Healer agent → Generated tests: repairs tests (evidence: `README.md`)
- Generated tests → Coverage manifest: indexed by (evidence: `README.md`)
- Generated tests → Login cases: covers (evidence: `README.md`)
- Generated tests → Inventory cases: covers (evidence: `README.md`)
- Generated tests → Sorting cases: covers (evidence: `README.md`)
- Generated tests → Product detail: covers (evidence: `README.md`)
- Generated tests → Cart cases: covers (evidence: `README.md`)
- Generated tests → Checkout cases: covers (evidence: `README.md`)
- Generated tests → Logout and reset: covers (evidence: `README.md`)
