# ahmadfauzi34/plw architecture

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

- Interactive diagram: https://gitdiagram.com/ahmadfauzi34/plw
- Repository: https://github.com/ahmadfauzi34/plw

## Overview

PLW is a standalone CLI reference machine for analyzing a target repository and helping agents orient to bounded, evidence-based code changes. Its principal workflow starts with an agent or engineer providing a target and task, then producing topology or task-relevant evidence and a bounded result; analysis does not itself authorize mutation. README documents additional simplification, UI, browser reproduction, causal-isolation, and capability-discovery surfaces. Runtime implementation is packaged in the digest-pinned capsule; the supplied excerpts do not expose its internal modules, so internal call wiring is not asserted.

Main entry points: [`runtime_source/plw-runtime-src.tar.gz`](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz) (PLW CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entrypoints"]
  node_plw["PLW CLI"]
  node_doctor["Doctor and version"]
end

subgraph group_analysis["Repository analysis"]
  node_topology["Topology"]
  node_impact["Impact analysis"]
  node_simplify["Simplification"]
  node_candidate["Candidate selection"]
end

subgraph group_ui["UI investigation"]
  node_ui_static["Static UI discovery"]
  node_ui_mapping["UI geometry mapping"]
  node_ui_diagnosis["UI bug analysis"]
  node_runtime_repro["Scenario reproduction"]
  node_causal["Causal isolation"]
end

subgraph group_agent["Agent support"]
  node_orient["Agent orientation"]
  node_capabilities["Capability discovery"]
  node_skills["Skill handoff"]
end

subgraph group_evidence["Bounded evidence"]
  node_bounded_pack["Bounded work pack"]
  node_validation["Scenario validation"]
end

node_engineer(("Engineer or agent"))
node_chromium["Chromium / Chrome"]
node_target["Target repository"]

node_engineer -->|"invokes"| node_plw
node_plw -->|"dispatches"| node_doctor
node_plw -->|"dispatches"| node_topology
node_plw -->|"dispatches"| node_impact
node_plw -->|"dispatches"| node_simplify
node_plw -->|"dispatches"| node_candidate
node_plw -->|"dispatches"| node_ui_static
node_plw -->|"dispatches"| node_ui_mapping
node_plw -->|"dispatches"| node_ui_diagnosis
node_plw -->|"dispatches"| node_runtime_repro
node_plw -->|"dispatches"| node_causal
node_plw -->|"dispatches"| node_orient
node_plw -->|"dispatches"| node_capabilities
node_plw -->|"dispatches"| node_skills
node_plw -->|"analyzes"| node_target
node_topology -->|"reads"| node_target
node_impact -->|"reads"| node_target
node_simplify -->|"reads"| node_target
node_ui_static -->|"reads"| node_target
node_ui_mapping -->|"analyzes"| node_target
node_runtime_repro -.->|"executes scenarios"| node_chromium
node_orient -->|"provides"| node_bounded_pack
node_orient -->|"includes handoff"| node_ui_static
node_causal -->|"supports verification"| node_validation
node_validation -.->|"executes scenarios"| node_chromium

click node_plw "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_doctor "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_topology "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_impact "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_simplify "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_candidate "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_ui_static "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_ui_mapping "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_ui_diagnosis "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_runtime_repro "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_causal "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_orient "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_capabilities "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_skills "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_bounded_pack "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"
click node_validation "https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz"

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_plw,node_doctor toneBlue
class node_topology,node_impact,node_simplify,node_candidate toneAmber
class node_ui_static,node_ui_mapping,node_ui_diagnosis,node_runtime_repro,node_causal toneMint
class node_orient,node_capabilities,node_skills toneRose
class node_bounded_pack,node_validation,node_engineer,node_chromium,node_target toneIndigo
```

## Components

### CLI entrypoints

- [PLW CLI](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Doctor and version](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`

### Repository analysis

- [Topology](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Impact analysis](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Simplification](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Candidate selection](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`

### UI investigation

- [Static UI discovery](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [UI geometry mapping](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [UI bug analysis](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Scenario reproduction](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Causal isolation](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`

### Agent support

- [Agent orientation](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Capability discovery](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Skill handoff](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`

### Bounded evidence

- [Bounded work pack](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`
- [Scenario validation](https://github.com/ahmadfauzi34/plw/blob/main/runtime_source/plw-runtime-src.tar.gz): `runtime_source/plw-runtime-src.tar.gz`

### Other components

- **Engineer or agent**
- **Chromium / Chrome**
- **Target repository**

## Connections

- Engineer or agent → PLW CLI: invokes
- PLW CLI → Doctor and version: dispatches
- PLW CLI → Topology: dispatches
- PLW CLI → Impact analysis: dispatches
- PLW CLI → Simplification: dispatches
- PLW CLI → Candidate selection: dispatches
- PLW CLI → Static UI discovery: dispatches
- PLW CLI → UI geometry mapping: dispatches
- PLW CLI → UI bug analysis: dispatches
- PLW CLI → Scenario reproduction: dispatches
- PLW CLI → Causal isolation: dispatches
- PLW CLI → Agent orientation: dispatches
- PLW CLI → Capability discovery: dispatches
- PLW CLI → Skill handoff: dispatches
- PLW CLI → Target repository: analyzes
- Topology → Target repository: reads
- Impact analysis → Target repository: reads
- Simplification → Target repository: reads
- Static UI discovery → Target repository: reads
- UI geometry mapping → Target repository: analyzes
- Scenario reproduction → Chromium / Chrome: executes scenarios
- Agent orientation → Bounded work pack: provides
- Agent orientation → Static UI discovery: includes handoff
- Causal isolation → Scenario validation: supports verification
- Scenario validation → Chromium / Chrome: executes scenarios