# rehan-remade/universal-modder architecture

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

- Interactive diagram: https://gitdiagram.com/rehan-remade/universal-modder
- Repository: https://github.com/rehan-remade/universal-modder

## Overview

Universal Modder equips AI coding agents with game-modding skills, a shared field-note knowledge base, and a Python CLI. The principal workflow searches prior notes, identifies a game and safe modding route, studies the game, builds and verifies a mod, creates assets, packages it, and records findings for future agents. The graph includes documented skill branches and CLI capabilities; several internal calls and unsampled skill implementations are represented only where the README or source index supports them.

Main entry points: [`skills/mod-any-game`](https://github.com/rehan-remade/universal-modder/tree/main/skills/mod-any-game) (Mod-any-game), [`um/cli.py`](https://github.com/rehan-remade/universal-modder/blob/main/um/cli.py) (um CLI), [`um/common.py`](https://github.com/rehan-remade/universal-modder/blob/main/um/common.py) (Shared helpers), [`um/kb.py`](https://github.com/rehan-remade/universal-modder/blob/main/um/kb.py) (Knowledge commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Agent skills"]
  node_mod_skill["Mod-any-game"]
  node_recon["Game recon"]
  node_reverse["Reverse engineering"]
  node_asset_skill["Asset pipeline"]
  node_fal_skill["Fal assets"]
  node_automation["Game automation"]
  node_video_skill["Showcase video"]
  node_publish_skill["Publish mod"]
  node_share_skill["Share field notes"]
end

subgraph group_knowledge["Field knowledge"]
  node_field_notes[("Field notes")]
  node_kb["Knowledge commands<br/>[kb.py]"]
end

subgraph group_cli["Modding tools"]
  node_cli["um CLI<br/>[cli.py]"]
  node_scan["Game scanner<br/>[scan.py]"]
  node_backup["Save backup<br/>[backup.py]"]
  node_common["Shared helpers<br/>[common.py]"]
end

subgraph group_assets["Asset production"]
  node_fal["Fal generation<br/>[fal.py]"]
  node_sprite["2D sprite tools<br/>[sprite.py]"]
  node_render3d["3D sprite render<br/>[render3d.py]"]
end

subgraph group_delivery["Verification and sharing"]
  node_win["Windows control<br/>[win.py]"]
  node_video["Video editing<br/>[video.py]"]
  node_publish["Publish checks<br/>[publish.py]"]
end

node_agent(("AI agent"))
node_game["Installed game"]

node_agent -->|"starts with"| node_mod_skill
node_mod_skill -->|"searches first"| node_field_notes
node_mod_skill -->|"recon then routes"| node_recon
node_recon -->|"uses scanner"| node_scan
node_mod_skill -->|"reads game code"| node_reverse
node_mod_skill -->|"builds mod for"| node_game
node_mod_skill -->|"backs up saves"| node_backup
node_mod_skill -->|"generates assets"| node_fal_skill
node_fal_skill -->|"uses generation CLI"| node_fal
node_asset_skill -->|"processes sprites"| node_sprite
node_asset_skill -->|"renders 3D"| node_render3d
node_mod_skill -->|"verifies in game"| node_automation
node_automation -->|"drives game"| node_win
node_mod_skill -->|"records showcase"| node_video_skill
node_video_skill -->|"uses video CLI"| node_video
node_mod_skill -->|"packages mod"| node_publish_skill
node_publish_skill -->|"checks package"| node_publish
node_mod_skill -->|"records findings"| node_share_skill
node_share_skill -->|"uses knowledge CLI"| node_kb
node_kb -->|"searches and updates"| node_field_notes
node_cli -->|"dispatches"| node_scan
node_cli -->|"dispatches"| node_fal
node_cli -->|"dispatches"| node_sprite
node_cli -->|"dispatches"| node_render3d
node_cli -->|"dispatches"| node_video
node_cli -->|"dispatches"| node_win
node_cli -->|"dispatches"| node_backup
node_cli -->|"dispatches"| node_publish
node_cli -->|"dispatches"| node_kb
node_scan -->|"uses helpers"| node_common
node_fal -->|"uses helpers"| node_common
node_sprite -->|"uses helpers"| node_common
node_render3d -->|"uses helpers"| node_common
node_video -->|"uses helpers"| node_common
node_win -->|"uses helpers"| node_common
node_backup -->|"uses helpers"| node_common
node_publish -->|"uses helpers"| node_common
node_kb -->|"uses helpers"| node_common
node_kb -->|"validates engine"| node_scan
node_kb -->|"opens PR"| node_publish

click node_mod_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/mod-any-game"
click node_recon "https://github.com/rehan-remade/universal-modder/tree/main/skills/game-recon"
click node_reverse "https://github.com/rehan-remade/universal-modder/tree/main/skills/reverse-engineering"
click node_asset_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/asset-pipeline"
click node_fal_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/fal-assets"
click node_automation "https://github.com/rehan-remade/universal-modder/tree/main/skills/game-automation"
click node_video_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/showcase-video"
click node_publish_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/publish-mod"
click node_share_skill "https://github.com/rehan-remade/universal-modder/tree/main/skills/share-field-notes"
click node_field_notes "https://github.com/rehan-remade/universal-modder/tree/main/knowledge"
click node_cli "https://github.com/rehan-remade/universal-modder/blob/main/um/cli.py"
click node_scan "https://github.com/rehan-remade/universal-modder/blob/main/um/scan.py"
click node_backup "https://github.com/rehan-remade/universal-modder/blob/main/um/backup.py"
click node_common "https://github.com/rehan-remade/universal-modder/blob/main/um/common.py"
click node_fal "https://github.com/rehan-remade/universal-modder/blob/main/um/fal.py"
click node_sprite "https://github.com/rehan-remade/universal-modder/blob/main/um/sprite.py"
click node_render3d "https://github.com/rehan-remade/universal-modder/blob/main/um/render3d.py"
click node_win "https://github.com/rehan-remade/universal-modder/blob/main/um/win.py"
click node_video "https://github.com/rehan-remade/universal-modder/blob/main/um/video.py"
click node_publish "https://github.com/rehan-remade/universal-modder/blob/main/um/publish.py"
click node_kb "https://github.com/rehan-remade/universal-modder/blob/main/um/kb.py"

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_mod_skill,node_recon,node_reverse,node_asset_skill,node_fal_skill,node_automation,node_video_skill,node_publish_skill,node_share_skill toneBlue
class node_field_notes,node_kb toneAmber
class node_cli,node_scan,node_backup,node_common toneMint
class node_fal,node_sprite,node_render3d toneRose
class node_win,node_video,node_publish,node_agent,node_game toneIndigo
```

## Components

### Agent skills

- [Mod-any-game](https://github.com/rehan-remade/universal-modder/tree/main/skills/mod-any-game): `skills/mod-any-game`
- [Game recon](https://github.com/rehan-remade/universal-modder/tree/main/skills/game-recon): `skills/game-recon`
- [Reverse engineering](https://github.com/rehan-remade/universal-modder/tree/main/skills/reverse-engineering): `skills/reverse-engineering`
- [Asset pipeline](https://github.com/rehan-remade/universal-modder/tree/main/skills/asset-pipeline): `skills/asset-pipeline`
- [Fal assets](https://github.com/rehan-remade/universal-modder/tree/main/skills/fal-assets): `skills/fal-assets`
- [Game automation](https://github.com/rehan-remade/universal-modder/tree/main/skills/game-automation): `skills/game-automation`
- [Showcase video](https://github.com/rehan-remade/universal-modder/tree/main/skills/showcase-video): `skills/showcase-video`
- [Publish mod](https://github.com/rehan-remade/universal-modder/tree/main/skills/publish-mod): `skills/publish-mod`
- [Share field notes](https://github.com/rehan-remade/universal-modder/tree/main/skills/share-field-notes): `skills/share-field-notes`

### Field knowledge

- [Field notes](https://github.com/rehan-remade/universal-modder/tree/main/knowledge): `knowledge`
- [Knowledge commands](https://github.com/rehan-remade/universal-modder/blob/main/um/kb.py): `um/kb.py`

### Modding tools

- [um CLI](https://github.com/rehan-remade/universal-modder/blob/main/um/cli.py): `um/cli.py`
- [Game scanner](https://github.com/rehan-remade/universal-modder/blob/main/um/scan.py): `um/scan.py`
- [Save backup](https://github.com/rehan-remade/universal-modder/blob/main/um/backup.py): `um/backup.py`
- [Shared helpers](https://github.com/rehan-remade/universal-modder/blob/main/um/common.py): `um/common.py`

### Asset production

- [Fal generation](https://github.com/rehan-remade/universal-modder/blob/main/um/fal.py): `um/fal.py`
- [2D sprite tools](https://github.com/rehan-remade/universal-modder/blob/main/um/sprite.py): `um/sprite.py`
- [3D sprite render](https://github.com/rehan-remade/universal-modder/blob/main/um/render3d.py): `um/render3d.py`

### Verification and sharing

- [Windows control](https://github.com/rehan-remade/universal-modder/blob/main/um/win.py): `um/win.py`
- [Video editing](https://github.com/rehan-remade/universal-modder/blob/main/um/video.py): `um/video.py`
- [Publish checks](https://github.com/rehan-remade/universal-modder/blob/main/um/publish.py): `um/publish.py`

### Other components

- **AI agent**
- **Installed game**

## Connections

- AI agent → Mod-any-game: starts with (evidence: `README.md`)
- Mod-any-game → Field notes: searches first (evidence: `README.md`)
- Mod-any-game → Game recon: recon then routes (evidence: `README.md`)
- Game recon → Game scanner: uses scanner (evidence: `README.md`)
- Mod-any-game → Reverse engineering: reads game code (evidence: `README.md`)
- Mod-any-game → Installed game: builds mod for (evidence: `README.md`)
- Mod-any-game → Save backup: backs up saves (evidence: `README.md`)
- Mod-any-game → Fal assets: generates assets (evidence: `README.md`)
- Fal assets → Fal generation: uses generation CLI (evidence: `README.md`)
- Asset pipeline → 2D sprite tools: processes sprites (evidence: `README.md`)
- Asset pipeline → 3D sprite render: renders 3D (evidence: `README.md`)
- Mod-any-game → Game automation: verifies in game (evidence: `README.md`)
- Game automation → Windows control: drives game (evidence: `README.md`)
- Mod-any-game → Showcase video: records showcase (evidence: `README.md`)
- Showcase video → Video editing: uses video CLI (evidence: `README.md`)
- Mod-any-game → Publish mod: packages mod (evidence: `README.md`)
- Publish mod → Publish checks: checks package (evidence: `README.md`)
- Mod-any-game → Share field notes: records findings (evidence: `README.md`)
- Share field notes → Knowledge commands: uses knowledge CLI (evidence: `README.md`)
- Knowledge commands → Field notes: searches and updates (evidence: `README.md`)
- um CLI → Game scanner: dispatches (evidence: `um/cli.py`)
- um CLI → Fal generation: dispatches (evidence: `um/cli.py`)
- um CLI → 2D sprite tools: dispatches (evidence: `um/cli.py`)
- um CLI → 3D sprite render: dispatches (evidence: `um/cli.py`)
- um CLI → Video editing: dispatches (evidence: `um/cli.py`)
- um CLI → Windows control: dispatches (evidence: `um/cli.py`)
- um CLI → Save backup: dispatches (evidence: `um/cli.py`)
- um CLI → Publish checks: dispatches (evidence: `um/cli.py`)
- um CLI → Knowledge commands: dispatches (evidence: `um/cli.py`)
- Game scanner → Shared helpers: uses helpers (evidence: `um/scan.py`)
- Fal generation → Shared helpers: uses helpers (evidence: `um/fal.py`)
- 2D sprite tools → Shared helpers: uses helpers (evidence: `um/sprite.py`)
- 3D sprite render → Shared helpers: uses helpers (evidence: `um/render3d.py`)
- Video editing → Shared helpers: uses helpers (evidence: `um/video.py`)
- Windows control → Shared helpers: uses helpers (evidence: `um/win.py`)
- Save backup → Shared helpers: uses helpers (evidence: `um/backup.py`)
- Publish checks → Shared helpers: uses helpers (evidence: `um/publish.py`)
- Knowledge commands → Shared helpers: uses helpers (evidence: `um/kb.py`)
- Knowledge commands → Game scanner: validates engine (evidence: `um/kb.py`)
- Knowledge commands → Publish checks: opens PR (evidence: `um/kb.py`)
