# llizell/pdp-audit architecture

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

- Interactive diagram: https://gitdiagram.com/llizell/pdp-audit
- Repository: https://github.com/llizell/pdp-audit

## Overview

pdp-audit is a Claude skill for evidence-based ecommerce product-detail-page audits. The documented workflow takes a URL or screenshots, captures or reviews page evidence, checks the page against compiled guidelines, and produces a prioritized report. The README describes these relationships; no source excerpts were provided, so implementation details beyond that documentation are not inferred.

Main entry points: [`SKILL.md`](https://github.com/llizell/pdp-audit/blob/main/SKILL.md) (PDP audit skill), [`references/pdp-guidelines.md`](https://github.com/llizell/pdp-audit/blob/main/references/pdp-guidelines.md) (PDP guidelines), [`examples/sample-report.md`](https://github.com/llizell/pdp-audit/blob/main/examples/sample-report.md) (Sample report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Audit inputs"]
  node_page_input["URL or screenshots"]
  node_browser["Browser tooling"]
end

subgraph group_review["Audit workflow"]
  node_audit_skill["PDP audit skill<br/>[SKILL.md]"]
  node_evidence["Page evidence"]
  node_page_inventory["Page inventory<br/>[SKILL.md]"]
end

subgraph group_knowledge["Guidance and output"]
  node_guidelines["PDP guidelines<br/>[pdp-guidelines.md]"]
  node_private_guidelines["Private guidelines"]
  node_audit_report["Prioritized report<br/>[SKILL.md]"]
  node_sample_report["Sample report<br/>[sample-report.md]"]
end

node_reviewer(("Reviewer"))

node_reviewer -->|"provides"| node_page_input
node_page_input -->|"starts audit"| node_audit_skill
node_audit_skill -.->|"uses optionally"| node_browser
node_audit_skill -->|"captures or reviews"| node_evidence
node_evidence -->|"informs"| node_page_inventory
node_audit_skill -->|"inventories"| node_page_inventory
node_audit_skill -->|"checks against"| node_guidelines
node_audit_skill -->|"loads optionally"| node_private_guidelines
node_audit_skill -->|"writes"| node_audit_report
node_audit_report -->|"delivers findings"| node_reviewer
node_reviewer -->|"can review"| node_sample_report

click node_audit_skill "https://github.com/llizell/pdp-audit/blob/main/SKILL.md"
click node_page_inventory "https://github.com/llizell/pdp-audit/blob/main/SKILL.md"
click node_guidelines "https://github.com/llizell/pdp-audit/blob/main/references/pdp-guidelines.md"
click node_audit_report "https://github.com/llizell/pdp-audit/blob/main/SKILL.md"
click node_sample_report "https://github.com/llizell/pdp-audit/blob/main/examples/sample-report.md"

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_page_input,node_browser,node_reviewer toneBlue
class node_audit_skill,node_evidence,node_page_inventory toneAmber
class node_guidelines,node_private_guidelines,node_audit_report,node_sample_report toneMint
```

## Components

### Audit inputs

- **URL or screenshots**
- **Browser tooling**

### Audit workflow

- [PDP audit skill](https://github.com/llizell/pdp-audit/blob/main/SKILL.md): `SKILL.md`
- **Page evidence**
- [Page inventory](https://github.com/llizell/pdp-audit/blob/main/SKILL.md): `SKILL.md`

### Guidance and output

- [PDP guidelines](https://github.com/llizell/pdp-audit/blob/main/references/pdp-guidelines.md): `references/pdp-guidelines.md`
- **Private guidelines**
- [Prioritized report](https://github.com/llizell/pdp-audit/blob/main/SKILL.md): `SKILL.md`
- [Sample report](https://github.com/llizell/pdp-audit/blob/main/examples/sample-report.md): `examples/sample-report.md`

### Other components

- **Reviewer**

## Connections

- Reviewer → URL or screenshots: provides (evidence: `README.md`)
- URL or screenshots → PDP audit skill: starts audit (evidence: `README.md`)
- PDP audit skill → Browser tooling: uses optionally (evidence: `README.md`)
- PDP audit skill → Page evidence: captures or reviews (evidence: `README.md`)
- Page evidence → Page inventory: informs (evidence: `README.md`)
- PDP audit skill → Page inventory: inventories (evidence: `README.md`)
- PDP audit skill → PDP guidelines: checks against (evidence: `README.md`)
- PDP audit skill → Private guidelines: loads optionally (evidence: `README.md`)
- PDP audit skill → Prioritized report: writes (evidence: `README.md`)
- Prioritized report → Reviewer: delivers findings (evidence: `README.md`)
- Reviewer → Sample report: can review (evidence: `README.md`)
