# amirmushichge/unreal-home-wizard architecture

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

- Interactive diagram: https://gitdiagram.com/amirmushichge/unreal-home-wizard
- Repository: https://github.com/amirmushichge/unreal-home-wizard

## Overview

Unreal Home Wizard is a Codex skill and local automation workflow that guides a beginner from project setup and room photographs to an Unreal project for review. The documented flow includes system preflight, project construction, Python-driven Unreal automation, and repeated photo-match and physical-logic QA. The platform-specific scripts and workflow references are represented from their names and README descriptions; source excerpts were unavailable, so uncertain script-to-script wiring is omitted.

Main entry points: [`skills/unreal-home-wizard/SKILL.md`](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/SKILL.md) (Wizard skill), [`skills/unreal-home-wizard/references/questionnaire.md`](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/questionnaire.md) (Questionnaire), [`skills/unreal-home-wizard/scripts/invoke-unreal-python.ps1`](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python.ps1) (Windows Python bridge), [`skills/unreal-home-wizard/scripts/invoke-unreal-python-macos.sh`](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python-macos.sh) (macOS Python bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Guided workflow"]
  node_skill["Wizard skill<br/>[SKILL.md]"]
  node_questionnaire["Questionnaire<br/>[questionnaire.md]"]
end

subgraph group_setup["Local setup"]
  node_preflight_win["Windows preflight<br/>[preflight.ps1]"]
  node_preflight_mac["macOS preflight<br/>[preflight-macos.sh]"]
end

subgraph group_construction["Project construction"]
  node_build_flow["Build flow<br/>[build-flow.md]"]
  node_project_win["Windows project setup"]
  node_project_mac["macOS project setup"]
  node_python_win["Windows Python bridge"]
  node_python_mac["macOS Python bridge"]
end

subgraph group_review["Review and QA"]
  node_project["Unreal project"]
  node_audit["Logic and fidelity audit"]
  node_quality["Quality bar<br/>[quality-bar.md]"]
end

node_user(("User"))
node_codex(("Codex"))
node_unreal["Unreal Engine"]

node_codex -->|"installs"| node_skill
node_user -->|"invokes"| node_skill
node_skill -->|"guides with"| node_questionnaire
node_questionnaire -->|"asks questions"| node_user
node_skill -->|"checks setup"| node_preflight_win
node_skill -.->|"checks setup"| node_preflight_mac
node_skill -->|"follows"| node_build_flow
node_skill -->|"creates project"| node_project_win
node_skill -.->|"creates project"| node_project_mac
node_skill -->|"runs scripts"| node_python_win
node_skill -.->|"runs scripts"| node_python_mac
node_python_win -->|"launches"| node_unreal
node_python_mac -.->|"launches"| node_unreal
node_unreal -->|"produces"| node_project
node_skill -->|"repeats QA"| node_audit
node_skill -->|"checks against"| node_quality
node_project -->|"reviewed by"| node_audit

click node_skill "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/SKILL.md"
click node_questionnaire "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/questionnaire.md"
click node_preflight_win "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/preflight.ps1"
click node_preflight_mac "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/preflight-macos.sh"
click node_build_flow "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/build-flow.md"
click node_project_win "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/new-home-project.ps1"
click node_project_mac "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/new-home-project-macos.sh"
click node_python_win "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python.ps1"
click node_python_mac "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python-macos.sh"
click node_audit "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/logic-and-fidelity-audit.md"
click node_quality "https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/quality-bar.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_skill,node_questionnaire,node_user toneBlue
class node_preflight_win,node_preflight_mac toneAmber
class node_build_flow,node_project_win,node_project_mac,node_python_win,node_python_mac toneMint
class node_project,node_audit,node_quality toneRose
class node_codex,node_unreal toneIndigo
```

## Components

### Guided workflow

- [Wizard skill](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/SKILL.md): `skills/unreal-home-wizard/SKILL.md`
- [Questionnaire](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/questionnaire.md): `skills/unreal-home-wizard/references/questionnaire.md`

### Local setup

- [Windows preflight](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/preflight.ps1): `skills/unreal-home-wizard/scripts/preflight.ps1`
- [macOS preflight](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/preflight-macos.sh): `skills/unreal-home-wizard/scripts/preflight-macos.sh`

### Project construction

- [Build flow](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/build-flow.md): `skills/unreal-home-wizard/references/build-flow.md`
- [Windows project setup](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/new-home-project.ps1): `skills/unreal-home-wizard/scripts/new-home-project.ps1`
- [macOS project setup](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/new-home-project-macos.sh): `skills/unreal-home-wizard/scripts/new-home-project-macos.sh`
- [Windows Python bridge](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python.ps1): `skills/unreal-home-wizard/scripts/invoke-unreal-python.ps1`
- [macOS Python bridge](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/scripts/invoke-unreal-python-macos.sh): `skills/unreal-home-wizard/scripts/invoke-unreal-python-macos.sh`

### Review and QA

- **Unreal project**
- [Logic and fidelity audit](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/logic-and-fidelity-audit.md): `skills/unreal-home-wizard/references/logic-and-fidelity-audit.md`
- [Quality bar](https://github.com/amirmushichge/unreal-home-wizard/blob/main/skills/unreal-home-wizard/references/quality-bar.md): `skills/unreal-home-wizard/references/quality-bar.md`

### Other components

- **User**
- **Codex**
- **Unreal Engine**

## Connections

- Codex → Wizard skill: installs
- User → Wizard skill: invokes
- Wizard skill → Questionnaire: guides with
- Questionnaire → User: asks questions
- Wizard skill → Windows preflight: checks setup
- Wizard skill → macOS preflight: checks setup
- Wizard skill → Build flow: follows
- Wizard skill → Windows project setup: creates project
- Wizard skill → macOS project setup: creates project
- Wizard skill → Windows Python bridge: runs scripts
- Wizard skill → macOS Python bridge: runs scripts
- Windows Python bridge → Unreal Engine: launches
- macOS Python bridge → Unreal Engine: launches
- Unreal Engine → Unreal project: produces
- Wizard skill → Logic and fidelity audit: repeats QA
- Wizard skill → Quality bar: checks against
- Unreal project → Logic and fidelity audit: reviewed by