unity-architecture

Define module boundaries and scene organization for Unity projects.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-architecture-krl76
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-architecture
Source: https://github.com/krl76/MP-Study-Projects/tree/main/Practice1/.codex/skills/unity-skills/skills/architecture
Command: npx skills add https://github.com/krl76/MP-Study-Projects --skill unity-architecture-krl76

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity projects often suffer from tangled code, unclear module boundaries, and fragile scene organization. This Skill provides a structured approach to architecture, guiding developers toward clean separation of concerns and scalable refactoring decisions.

Core Features & Use Cases

  • Defines recommended module boundaries and a lightweight layering plan (scene/bootstrap, domain logic, data/config, view/presentation).
  • Advises on explicit startup order, dependency management, and thin composition bridges with ScriptableObjects for config data.
  • Use Case: Before adding many gameplay scripts, run Architecture Advisor to outline core systems and interfaces for a maintainable project.

Quick Start

Proactively outline core modules, scene roles, and data ownership in a Unity project and create a minimal bootstrap script to initialize them.

Frequently Asked Questions about unity-architecture

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

FAQPage Schema
How do I fix tangled Unity code and unclear module boundaries in my project?

To fix tangled Unity code and unclear module boundaries, establish a lightweight layering plan separating scene/bootstrap, domain logic, data/config, and view/presentation. This enforces clean separation of concerns for scalable refactoring and maintainable project structure.

What's the best way to organize Unity scenes and bootstrap scripts for decoupled systems?

Organize Unity scenes and bootstrap scripts by defining explicit startup ordering and thin composition bridges. Use ScriptableObjects for config data to keep MonoBehaviours lightweight and ensure clear separation of concerns across decoupled systems.

When should I plan Unity project architecture and module separation?

Plan Unity project architecture and module separation during early design phases before adding many gameplay scripts. Outlining core systems and interfaces early prevents fragile scene organization and ensures maintainable prototype-to-production workflows.

How do I refactor a Unity project to follow SOLID principles and decoupled systems?

Refactor a Unity project for SOLID principles and decoupled systems by defining clear module boundaries and data ownership. Apply lightweight composition bridges and ScriptableObject configs to reduce direct dependencies and isolate domain logic.

Can I use ScriptableObject configs for dependency management in Unity architecture?

Yes, use ScriptableObject configs for dependency management in Unity architecture to provide lightweight MonoBehaviour usage and thin composition bridges. This approach separates data ownership from domain logic and ensures clear separation of concerns.