unity-architecture

Advises on Unity gameplay architecture, module boundaries, decoupling, and refactor direction.

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-architecture-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-architecture
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/architecture
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-architecture-darth-carrotpie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects often grow into tangled codebases with hidden dependencies, unpredictable script execution order, and over-engineered frameworks. This Skill provides structured architectural guidance before you write structural code, helping you choose the smallest architecture that fits your project's scope. ## Core Features & Use Cases - Scoped Architecture Planning: Recommends 3-7 modules with clear responsibilities based on project tier (prototype, small game, or long-lived project), separating scene/bootstrap, gameplay logic, data assets, and presentation layers. - Execution Order & Guard Patterns: Provides concrete patterns for explicit startup ordering (single Bootstrap entry point, pull-don't-push data flow) and Update guard clauses that prevent null-data corruption bugs. - Refactor Direction Advice: Helps decide what to abstract now versus keep simple, avoiding framework-heavy over-engineering. - Use Case: Before building a new gameplay system, ask for an architecture plan and receive a module breakdown, scene composition strategy, data ownership rules, and communication patterns (direct refs, interfaces, events, or commands). ## Quick Start Ask the agent to plan the architecture for a small Unity game with player combat, inventory, and UI systems before writing any scripts.

Frequently Asked Questions about unity-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a Unity project architecture?▼

Start by identifying your project tier (prototype, small game, or long-lived), then define 3-7 modules with single responsibilities. Separate scene/bootstrap, gameplay logic, data config, and presentation layers, and keep MonoBehaviours thin as composition bridges.

How to fix Unity script execution order problems?▼

Use a single Bootstrap script with [DefaultExecutionOrder(-10000)] as the only entry point that initializes managers explicitly. Prefer pull-based data access over pushing data in Awake, and reserve execution order attributes for 3-4 load-bearing scripts at most.

When should I use ScriptableObjects in Unity architecture?▼

Use ScriptableObjects for authored configuration and shared static data, not as a default dump for runtime state. Put reusable gameplay rules in plain C# classes and keep runtime state in explicitly owned objects.

Why does my Unity Update method run with null data?▼

Update runs every frame regardless of whether dependencies are ready. Add guard clauses at the top of Update that early-return when initialization flags, data sources, or gameplay state are not ready, checking the cheapest condition first.

When is a Unity architecture over-engineered?▼

Architecture is over-engineered when you add layers to satisfy textbook SOLID wording or build a reusable framework before the project needs it. Prefer a small architecture that can grow over an impressive one that slows iteration.