# sdzdrccc/ue-ai-ops architecture

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

- Interactive diagram: https://gitdiagram.com/sdzdrccc/ue-ai-ops
- Repository: https://github.com/sdzdrccc/ue-ai-ops

## Overview

ue-ai-ops is an operational handbook and small toolset for helping AI agents and developers make Unreal Engine project changes take effect and verify them. The workflow is to consult the skill or relevant reference, choose an editor/compile or asset-editing approach, connect through documented MCP options when needed, and check the resulting state. The README also describes official toolsets, pitfalls guidance, and collected test evidence. No source excerpts were provided, so relationships below are limited to those explicitly documented in the README.

Main entry points: [`INSTALL.md`](https://github.com/sdzdrccc/ue-ai-ops/blob/main/INSTALL.md) (Install Guide), [`scripts/sync-to-skill.sh`](https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/sync-to-skill.sh) (Skill Sync), [`references/06-sampling-test-report.md`](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/06-sampling-test-report.md) (Sampling Report), [`SKILL.md`](https://github.com/sdzdrccc/ue-ai-ops/blob/main/SKILL.md) (Agent Skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Entry and Distribution"]
  node_skill["Agent Skill<br/>[SKILL.md]"]
  node_install["Install Guide<br/>[INSTALL.md]"]
  node_sync["Skill Sync<br/>[sync-to-skill.sh]"]
end

subgraph group_operations["UE Operations"]
  node_compile_launch["Compile and Launch"]
  node_umg_assets["UMG and Assets"]
  node_pitfalls["Pitfall Guidance"]
end

subgraph group_integrations["Editor Integration"]
  node_mcp_channel["MCP Channel"]
  node_official_tools["Official Toolsets"]
end

subgraph group_validation["Evidence and Checks"]
  node_sampling_report["Sampling Report"]
  node_evidence["Raw Evidence"]
  node_editor_info["Editor State Probe"]
  node_checker["Repository Checks<br/>[check.sh]"]
end

node_ai_dev(("AI or Developer"))

node_ai_dev -->|"reads skill"| node_skill
node_ai_dev -->|"consults"| node_compile_launch
node_ai_dev -->|"consults"| node_mcp_channel
node_ai_dev -->|"consults"| node_umg_assets
node_ai_dev -->|"consults"| node_pitfalls
node_ai_dev -->|"consults"| node_official_tools
node_ai_dev -->|"consults"| node_sampling_report
node_ai_dev -->|"runs for status"| node_editor_info
node_ai_dev -->|"follows install"| node_install
node_install -->|"documents use"| node_sync
node_sync -->|"copies source"| node_skill
node_sampling_report -->|"documents evidence"| node_evidence
node_ai_dev -->|"runs checks"| node_checker

click node_skill "https://github.com/sdzdrccc/ue-ai-ops/blob/main/SKILL.md"
click node_install "https://github.com/sdzdrccc/ue-ai-ops/blob/main/INSTALL.md"
click node_sync "https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/sync-to-skill.sh"
click node_compile_launch "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/01-compile-and-launch.md"
click node_mcp_channel "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/02-editor-mcp-channel.md"
click node_umg_assets "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/03-umg-and-assets.md"
click node_pitfalls "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/04-avoiding-pitfalls.md"
click node_official_tools "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/05-official-mcp-and-toolsets.md"
click node_sampling_report "https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/06-sampling-test-report.md"
click node_evidence "https://github.com/sdzdrccc/ue-ai-ops/tree/main/docs/evidence"
click node_editor_info "https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/find-ue-editor-info.sh"
click node_checker "https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/check.sh"

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_install,node_sync toneBlue
class node_compile_launch,node_umg_assets,node_pitfalls toneAmber
class node_mcp_channel,node_official_tools toneMint
class node_sampling_report,node_evidence,node_editor_info,node_checker toneRose
class node_ai_dev toneIndigo
```

## Components

### Entry and Distribution

- [Agent Skill](https://github.com/sdzdrccc/ue-ai-ops/blob/main/SKILL.md): `SKILL.md`
- [Install Guide](https://github.com/sdzdrccc/ue-ai-ops/blob/main/INSTALL.md): `INSTALL.md`
- [Skill Sync](https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/sync-to-skill.sh): `scripts/sync-to-skill.sh`

### UE Operations

- [Compile and Launch](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/01-compile-and-launch.md): `references/01-compile-and-launch.md`
- [UMG and Assets](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/03-umg-and-assets.md): `references/03-umg-and-assets.md`
- [Pitfall Guidance](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/04-avoiding-pitfalls.md): `references/04-avoiding-pitfalls.md`

### Editor Integration

- [MCP Channel](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/02-editor-mcp-channel.md): `references/02-editor-mcp-channel.md`
- [Official Toolsets](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/05-official-mcp-and-toolsets.md): `references/05-official-mcp-and-toolsets.md`

### Evidence and Checks

- [Sampling Report](https://github.com/sdzdrccc/ue-ai-ops/blob/main/references/06-sampling-test-report.md): `references/06-sampling-test-report.md`
- [Raw Evidence](https://github.com/sdzdrccc/ue-ai-ops/tree/main/docs/evidence): `docs/evidence`
- [Editor State Probe](https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/find-ue-editor-info.sh): `scripts/find-ue-editor-info.sh`
- [Repository Checks](https://github.com/sdzdrccc/ue-ai-ops/blob/main/scripts/check.sh): `scripts/check.sh`

### Other components

- **AI or Developer**

## Connections

- AI or Developer → Agent Skill: reads skill (evidence: `README.md`)
- AI or Developer → Compile and Launch: consults (evidence: `README.md`)
- AI or Developer → MCP Channel: consults (evidence: `README.md`)
- AI or Developer → UMG and Assets: consults (evidence: `README.md`)
- AI or Developer → Pitfall Guidance: consults (evidence: `README.md`)
- AI or Developer → Official Toolsets: consults (evidence: `README.md`)
- AI or Developer → Sampling Report: consults (evidence: `README.md`)
- AI or Developer → Editor State Probe: runs for status (evidence: `README.md`)
- AI or Developer → Install Guide: follows install (evidence: `README.md`)
- Install Guide → Skill Sync: documents use (evidence: `README.md`)
- Skill Sync → Agent Skill: copies source (evidence: `README.md`)
- Sampling Report → Raw Evidence: documents evidence (evidence: `README.md`)
- AI or Developer → Repository Checks: runs checks (evidence: `README.md`)
