# jayguajardo/agentic-playwright-example architecture

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

- Interactive diagram: https://gitdiagram.com/jayguajardo/agentic-playwright-example
- Repository: https://github.com/jayguajardo/agentic-playwright-example

## Overview

This repository is an Agentic Playwright example: it combines a TechMart browser/API test suite with test plans, page objects, test data, and Claude Code Playwright agents. The main workflow is planning and generating tests, then running them against the sample site; the README also describes a healer agent. Source excerpts cover only the package and Playwright configuration, so links among individual test files and page objects are limited to relationships documented in the README.

Main entry points: [`tests/home`](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/home) (Browser Tests), [`tests/login`](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/login) (Login Tests), [`.claude/agents`](https://github.com/jayguajardo/agentic-playwright-example/tree/main/.claude/agents) (Playwright Agents), [`tests/pages`](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/pages) (Page Objects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Planning and Agents"]
  node_agents["Playwright Agents<br/>[agents]"]
  node_plans["Test Plans"]
end

subgraph group_tests["Test Coverage"]
  node_ui_tests["Browser Tests"]
  node_login_tests["Login Tests"]
  node_api_tests["API Tests"]
end

subgraph group_support["Test Support"]
  node_pages["Page Objects"]
  node_data["Test Data"]
end

node_developer(("Test Author"))
node_techmart["TechMart Site"]

node_developer -->|"uses"| node_agents
node_agents -->|"plan and generate"| node_ui_tests
node_ui_tests -->|"test against"| node_techmart
node_login_tests -->|"test against"| node_techmart
node_api_tests -->|"test against"| node_techmart
node_ui_tests -->|"use page objects"| node_pages
node_login_tests -->|"use page objects"| node_pages
node_ui_tests -->|"use test data"| node_data
node_login_tests -->|"use test data"| node_data

click node_agents "https://github.com/jayguajardo/agentic-playwright-example/tree/main/.claude/agents"
click node_plans "https://github.com/jayguajardo/agentic-playwright-example/tree/main/specs"
click node_ui_tests "https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/home"
click node_login_tests "https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/login"
click node_api_tests "https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/api"
click node_pages "https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/pages"
click node_data "https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/data"

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_agents,node_plans toneBlue
class node_ui_tests,node_login_tests,node_api_tests toneAmber
class node_pages,node_data toneMint
class node_developer,node_techmart toneIndigo
```

## Components

### Planning and Agents

- [Playwright Agents](https://github.com/jayguajardo/agentic-playwright-example/tree/main/.claude/agents): `.claude/agents`
- [Test Plans](https://github.com/jayguajardo/agentic-playwright-example/tree/main/specs): `specs`

### Test Coverage

- [Browser Tests](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/home): `tests/home`
- [Login Tests](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/login): `tests/login`
- [API Tests](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/api): `tests/api`

### Test Support

- [Page Objects](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/pages): `tests/pages`
- [Test Data](https://github.com/jayguajardo/agentic-playwright-example/tree/main/tests/data): `tests/data`

### Other components

- **Test Author**
- **TechMart Site**

## Connections

- Test Author → Playwright Agents: uses (evidence: `README.md`)
- Playwright Agents → Browser Tests: plan and generate (evidence: `README.md`)
- Browser Tests → TechMart Site: test against (evidence: `README.md`)
- Login Tests → TechMart Site: test against (evidence: `README.md`)
- API Tests → TechMart Site: test against (evidence: `README.md`)
- Browser Tests → Page Objects: use page objects (evidence: `README.md`)
- Login Tests → Page Objects: use page objects (evidence: `README.md`)
- Browser Tests → Test Data: use test data (evidence: `README.md`)
- Login Tests → Test Data: use test data (evidence: `README.md`)
