# lilmgenius/paperthin architecture

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

- Interactive diagram: https://gitdiagram.com/lilmgenius/paperthin
- Repository: https://github.com/lilmgenius/paperthin

## Overview

Paperthin is a portable catalog of agent skills: users invoke a skill through their agent, which applies its instructions to an artifact, task, or project cycle. Its capabilities are organized as depth (one artifact), breadth (many artifacts), coil (iterations), and mesh (multiple perspectives). README describes the catalog and workflows; sampled source only covers discovery-notice adapters and shared catalog logic, so skill-to-skill links are shown only where the documented coil loop supports them.

Main entry points: [`skills/coil/re0-loop/SKILL.md`](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-loop/SKILL.md) (Run iteration loop), [`skills/coil/re0-memo/SKILL.md`](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-memo/SKILL.md) (Extract lessons), [`skills/coil/re0-work/SKILL.md`](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-work/SKILL.md) (Restart from v0), [`skills/depth/re0/SKILL.md`](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/re0/SKILL.md) (Rewrite v0)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_depth["Depth skills"]
  node_re0["Rewrite v0<br/>[SKILL.md]"]
  node_readchk["Clarify request<br/>[SKILL.md]"]
  node_aim["Infer intent<br/>[SKILL.md]"]
  node_modelchk["Size effort<br/>[SKILL.md]"]
  node_macrothink["Independent reads<br/>[SKILL.md]"]
  node_feynman["Probe decision<br/>[SKILL.md]"]
  node_autobahn["Bound safe scope<br/>[SKILL.md]"]
  node_factchk["Verify claims<br/>[SKILL.md]"]
end

subgraph group_breadth["Breadth skills"]
  node_ssotize["Consolidate truth<br/>[SKILL.md]"]
  node_upgrade["Upgrade catalog<br/>[SKILL.md]"]
end

subgraph group_coil["Coil skills"]
  node_plan["Open cycle<br/>[SKILL.md]"]
  node_loop["Run iteration loop<br/>[SKILL.md]"]
  node_memo["Extract lessons<br/>[SKILL.md]"]
  node_work["Restart from v0<br/>[SKILL.md]"]
  node_catchup["Recover context<br/>[SKILL.md]"]
  node_nba["Choose next action<br/>[SKILL.md]"]
end

subgraph group_mesh["Mesh skills"]
  node_prism["Compare perspectives<br/>[SKILL.md]"]
end

node_user(("User"))
node_agent["Agent host"]
node_artifact["Work artifact"]

node_user -->|"requests work"| node_agent
node_agent -->|"invokes"| node_re0
node_agent -->|"invokes"| node_readchk
node_agent -->|"invokes"| node_aim
node_agent -->|"invokes"| node_modelchk
node_agent -->|"invokes"| node_macrothink
node_agent -->|"invokes"| node_feynman
node_agent -->|"invokes"| node_autobahn
node_agent -->|"invokes"| node_factchk
node_agent -->|"invokes"| node_ssotize
node_agent -->|"invokes"| node_upgrade
node_agent -->|"invokes"| node_plan
node_agent -->|"invokes"| node_loop
node_agent -->|"invokes"| node_memo
node_agent -->|"invokes"| node_work
node_agent -->|"invokes"| node_catchup
node_agent -->|"invokes"| node_nba
node_agent -->|"invokes"| node_prism
node_re0 -->|"rewrites"| node_artifact
node_readchk -->|"checks"| node_artifact
node_aim -->|"interprets"| node_artifact
node_modelchk -->|"sizes work"| node_artifact
node_macrothink -->|"analyzes"| node_artifact
node_feynman -->|"probes"| node_artifact
node_autobahn -->|"bounds scope"| node_artifact
node_factchk -->|"verifies"| node_artifact
node_ssotize -->|"consolidates"| node_artifact
node_prism -->|"reviews lenses"| node_artifact
node_plan -->|"prepares cycle"| node_loop
node_loop -->|"runs"| node_memo
node_loop -->|"runs"| node_work
node_memo -->|"records lessons"| node_artifact
node_work -->|"restarts"| node_artifact
node_catchup -->|"recovers context"| node_artifact
node_nba -->|"reads state"| node_artifact

click node_re0 "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/re0/SKILL.md"
click node_readchk "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/readchk/SKILL.md"
click node_aim "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/aim/SKILL.md"
click node_modelchk "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/modelchk/SKILL.md"
click node_macrothink "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/macrothink/SKILL.md"
click node_feynman "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/feynman/SKILL.md"
click node_autobahn "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/autobahn/SKILL.md"
click node_factchk "https://github.com/lilmgenius/paperthin/blob/main/skills/depth/factchk/SKILL.md"
click node_ssotize "https://github.com/lilmgenius/paperthin/blob/main/skills/breadth/ssotize/SKILL.md"
click node_upgrade "https://github.com/lilmgenius/paperthin/blob/main/skills/breadth/re0-upgrade/SKILL.md"
click node_plan "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-plan/SKILL.md"
click node_loop "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-loop/SKILL.md"
click node_memo "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-memo/SKILL.md"
click node_work "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-work/SKILL.md"
click node_catchup "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/catchup/SKILL.md"
click node_nba "https://github.com/lilmgenius/paperthin/blob/main/skills/coil/nba/SKILL.md"
click node_prism "https://github.com/lilmgenius/paperthin/blob/main/skills/mesh/prism/SKILL.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_re0,node_readchk,node_aim,node_modelchk,node_macrothink,node_feynman,node_autobahn,node_factchk,node_user toneBlue
class node_ssotize,node_upgrade toneAmber
class node_plan,node_loop,node_memo,node_work,node_catchup,node_nba toneMint
class node_prism toneRose
class node_agent,node_artifact toneIndigo
```

## Components

### Depth skills

- [Rewrite v0](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/re0/SKILL.md): `skills/depth/re0/SKILL.md`
- [Clarify request](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/readchk/SKILL.md): `skills/depth/readchk/SKILL.md`
- [Infer intent](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/aim/SKILL.md): `skills/depth/aim/SKILL.md`
- [Size effort](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/modelchk/SKILL.md): `skills/depth/modelchk/SKILL.md`
- [Independent reads](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/macrothink/SKILL.md): `skills/depth/macrothink/SKILL.md`
- [Probe decision](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/feynman/SKILL.md): `skills/depth/feynman/SKILL.md`
- [Bound safe scope](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/autobahn/SKILL.md): `skills/depth/autobahn/SKILL.md`
- [Verify claims](https://github.com/lilmgenius/paperthin/blob/main/skills/depth/factchk/SKILL.md): `skills/depth/factchk/SKILL.md`

### Breadth skills

- [Consolidate truth](https://github.com/lilmgenius/paperthin/blob/main/skills/breadth/ssotize/SKILL.md): `skills/breadth/ssotize/SKILL.md`
- [Upgrade catalog](https://github.com/lilmgenius/paperthin/blob/main/skills/breadth/re0-upgrade/SKILL.md): `skills/breadth/re0-upgrade/SKILL.md`

### Coil skills

- [Open cycle](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-plan/SKILL.md): `skills/coil/re0-plan/SKILL.md`
- [Run iteration loop](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-loop/SKILL.md): `skills/coil/re0-loop/SKILL.md`
- [Extract lessons](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-memo/SKILL.md): `skills/coil/re0-memo/SKILL.md`
- [Restart from v0](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/re0-work/SKILL.md): `skills/coil/re0-work/SKILL.md`
- [Recover context](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/catchup/SKILL.md): `skills/coil/catchup/SKILL.md`
- [Choose next action](https://github.com/lilmgenius/paperthin/blob/main/skills/coil/nba/SKILL.md): `skills/coil/nba/SKILL.md`

### Mesh skills

- [Compare perspectives](https://github.com/lilmgenius/paperthin/blob/main/skills/mesh/prism/SKILL.md): `skills/mesh/prism/SKILL.md`

### Other components

- **User**
- **Agent host**
- **Work artifact**

## Connections

- User → Agent host: requests work
- Agent host → Rewrite v0: invokes
- Agent host → Clarify request: invokes
- Agent host → Infer intent: invokes
- Agent host → Size effort: invokes
- Agent host → Independent reads: invokes
- Agent host → Probe decision: invokes
- Agent host → Bound safe scope: invokes
- Agent host → Verify claims: invokes
- Agent host → Consolidate truth: invokes
- Agent host → Upgrade catalog: invokes
- Agent host → Open cycle: invokes
- Agent host → Run iteration loop: invokes
- Agent host → Extract lessons: invokes
- Agent host → Restart from v0: invokes
- Agent host → Recover context: invokes
- Agent host → Choose next action: invokes
- Agent host → Compare perspectives: invokes
- Rewrite v0 → Work artifact: rewrites
- Clarify request → Work artifact: checks
- Infer intent → Work artifact: interprets
- Size effort → Work artifact: sizes work
- Independent reads → Work artifact: analyzes
- Probe decision → Work artifact: probes
- Bound safe scope → Work artifact: bounds scope
- Verify claims → Work artifact: verifies
- Consolidate truth → Work artifact: consolidates
- Compare perspectives → Work artifact: reviews lenses
- Open cycle → Run iteration loop: prepares cycle
- Run iteration loop → Extract lessons: runs
- Run iteration loop → Restart from v0: runs
- Extract lessons → Work artifact: records lessons
- Restart from v0 → Work artifact: restarts
- Recover context → Work artifact: recovers context
- Choose next action → Work artifact: reads state