unity-architecture

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

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-architecture-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-architecture
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/architecture
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-architecture-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects often grow into tangled MonoBehaviour scripts with hidden execution-order bugs and unclear responsibilities. This Skill helps you plan a right-sized architecture before writing structural code, so you avoid both under-organization and over-engineering. ## Core Features & Use Cases - Scoped Architecture Planning: Recommends the smallest architecture that fits your project tier (prototype, small game, or long-lived project) with 3-7 modules and clear responsibilities. - Execution Order & Guard Guidance: Provides concrete patterns for explicit startup order (single Bootstrap entry point, pull-don't-push) and Update guard clauses to prevent silent state corruption. - Layered Separation Advice: Structures guidance around scene/bootstrap, gameplay logic, data/config assets, and presentation layers, with rules for ScriptableObjects, events, and interfaces. - Use Case: Before building a new gameplay system, ask for an architecture plan and receive a module breakdown, scene composition plan, data ownership rules, and a do-now/skip-now list. ## Quick Start Ask the assistant to plan the architecture for your Unity game, describing your project scope and core gameplay loop.

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 assets, 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 access where subscribers call GetValue() instead of publishers pushing data during Awake.

When should I use ScriptableObjects in Unity?

Use ScriptableObjects for authored configuration and shared static data, not as a default dump for runtime state. Runtime state belongs in plain C# classes or scene objects with explicit ownership.

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.

When is a Unity architecture over-engineered?

If more than 3-4 scripts need DefaultExecutionOrder attributes, or you are adding layers just to satisfy textbook SOLID wording, the architecture is too heavy. Prefer a small structure that can grow over an impressive framework that slows iteration.