# axxx503/arabic-localization-game architecture

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

- Interactive diagram: https://gitdiagram.com/axxx503/arabic-localization-game
- Repository: https://github.com/axxx503/arabic-localization-game

## Overview

This repository is a prompt-led Arabic game-localization framework, supported by an Antigravity skill, Python text/font utilities, and an applied game example. The documented workflow starts with an AI coding agent inspecting extracted game assets, then translating and preparing Arabic text and fonts, and finally producing an installable object-level patch. The README describes the broader engine/tool coverage; the sampled Python files establish only the shaping and font-merging behavior, so those broader links are cited to the README.

Main entry points: [`examples/over-the-hill/package`](https://github.com/axxx503/arabic-localization-game/tree/main/examples/over-the-hill/package) (Patch Package), [`prompts/SMART_ARABIC_LOCALIZATION_PROMPT_EN.md`](https://github.com/axxx503/arabic-localization-game/blob/main/prompts/SMART_ARABIC_LOCALIZATION_PROMPT_EN.md) (Localization Prompt), [`toolkit/arabic_font_merger.py`](https://github.com/axxx503/arabic-localization-game/blob/main/toolkit/arabic_font_merger.py) (Font Merger), [`antigravity-skill/arabic-game-localization/SKILL.md`](https://github.com/axxx503/arabic-localization-game/blob/main/antigravity-skill/arabic-game-localization/SKILL.md) (Antigravity Skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Localization Guidance"]
  node_prompt["Localization Prompt"]
  node_skill["Antigravity Skill<br/>[SKILL.md]"]
end

subgraph group_processing["Arabic Processing"]
  node_text_shaper["Text Shaping"]
  node_font_merger["Font Merger"]
end

subgraph group_delivery["Patch Delivery"]
  node_package["Patch Package"]
  node_patch_tool["Patch Applier<br/>[apply_patch.py]"]
  node_installer["Install Scripts<br/>[Install-Arabic.ps1]"]
  node_uninstaller["Uninstall Scripts"]
end

subgraph group_example["Applied Example"]
  node_translations["Arabic Translations<br/>[Content_ar.json]"]
  node_case_study["Localization Case Study<br/>[CASE_STUDY_AR.md]"]
end

node_user(("Game Localizer"))
node_agent{{"AI Coding Agent"}}
node_game[("Game Files")]
node_engine_tools["Engine Extraction Tools"]
node_game_font["Game Font Assets"]

node_user -->|"uses"| node_prompt
node_prompt -->|"guides"| node_agent
node_skill -->|"guides"| node_agent
node_agent -->|"inspects"| node_game
node_engine_tools -.->|"extracts assets"| node_game
node_agent -.->|"produces"| node_translations
node_agent -.->|"shapes text"| node_text_shaper
node_agent -.->|"prepares fonts"| node_font_merger
node_font_merger -->|"merges glyphs"| node_game_font
node_agent -->|"builds patch"| node_package
node_patch_tool -.->|"applies objects"| node_package
node_installer -.->|"installs"| node_package
node_uninstaller -.->|"removes"| node_package
node_case_study -.->|"documents example"| node_package

click node_prompt "https://github.com/axxx503/arabic-localization-game/blob/main/prompts/SMART_ARABIC_LOCALIZATION_PROMPT_EN.md"
click node_skill "https://github.com/axxx503/arabic-localization-game/blob/main/antigravity-skill/arabic-game-localization/SKILL.md"
click node_translations "https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/translations/Content_ar.json"
click node_text_shaper "https://github.com/axxx503/arabic-localization-game/blob/main/toolkit/safe_arabic_shaper.py"
click node_font_merger "https://github.com/axxx503/arabic-localization-game/blob/main/toolkit/arabic_font_merger.py"
click node_package "https://github.com/axxx503/arabic-localization-game/tree/main/examples/over-the-hill/package"
click node_patch_tool "https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/tools/apply_patch.py"
click node_installer "https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/Install-Arabic.ps1"
click node_uninstaller "https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/Uninstall-Arabic.ps1"
click node_case_study "https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/CASE_STUDY_AR.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_prompt,node_skill toneBlue
class node_text_shaper,node_font_merger,node_game toneAmber
class node_package,node_patch_tool,node_installer,node_uninstaller toneMint
class node_translations,node_case_study toneRose
class node_user,node_agent,node_engine_tools,node_game_font toneIndigo
```

## Components

### Localization Guidance

- [Localization Prompt](https://github.com/axxx503/arabic-localization-game/blob/main/prompts/SMART_ARABIC_LOCALIZATION_PROMPT_EN.md): `prompts/SMART_ARABIC_LOCALIZATION_PROMPT_EN.md`
- [Antigravity Skill](https://github.com/axxx503/arabic-localization-game/blob/main/antigravity-skill/arabic-game-localization/SKILL.md): `antigravity-skill/arabic-game-localization/SKILL.md`

### Arabic Processing

- [Text Shaping](https://github.com/axxx503/arabic-localization-game/blob/main/toolkit/safe_arabic_shaper.py): `toolkit/safe_arabic_shaper.py`
- [Font Merger](https://github.com/axxx503/arabic-localization-game/blob/main/toolkit/arabic_font_merger.py): `toolkit/arabic_font_merger.py`

### Patch Delivery

- [Patch Package](https://github.com/axxx503/arabic-localization-game/tree/main/examples/over-the-hill/package): `examples/over-the-hill/package`
- [Patch Applier](https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/tools/apply_patch.py): `examples/over-the-hill/package/tools/apply_patch.py`
- [Install Scripts](https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/Install-Arabic.ps1): `examples/over-the-hill/package/Install-Arabic.ps1`
- [Uninstall Scripts](https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/package/Uninstall-Arabic.ps1): `examples/over-the-hill/package/Uninstall-Arabic.ps1`

### Applied Example

- [Arabic Translations](https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/translations/Content_ar.json): `examples/over-the-hill/translations/Content_ar.json`
- [Localization Case Study](https://github.com/axxx503/arabic-localization-game/blob/main/examples/over-the-hill/CASE_STUDY_AR.md): `examples/over-the-hill/CASE_STUDY_AR.md`

### Other components

- **Game Localizer**
- **AI Coding Agent**
- **Game Files**
- **Engine Extraction Tools**
- **Game Font Assets**

## Connections

- Game Localizer → Localization Prompt: uses (evidence: `README.md`)
- Localization Prompt → AI Coding Agent: guides (evidence: `README.md`)
- Antigravity Skill → AI Coding Agent: guides (evidence: `README.md`)
- AI Coding Agent → Game Files: inspects (evidence: `README.md`)
- Engine Extraction Tools → Game Files: extracts assets (evidence: `README.md`)
- AI Coding Agent → Arabic Translations: produces (evidence: `README.md`)
- AI Coding Agent → Text Shaping: shapes text (evidence: `README.md`)
- AI Coding Agent → Font Merger: prepares fonts (evidence: `README.md`)
- Font Merger → Game Font Assets: merges glyphs (evidence: `toolkit/arabic_font_merger.py`)
- AI Coding Agent → Patch Package: builds patch (evidence: `README.md`)
- Patch Applier → Patch Package: applies objects (evidence: `README.md`)
- Install Scripts → Patch Package: installs (evidence: `README.md`)
- Uninstall Scripts → Patch Package: removes (evidence: `README.md`)
- Localization Case Study → Patch Package: documents example (evidence: `README.md`)
