Unity Development Guide

Battle-tested best practices for Unity, from project setup to shipping. This is the entry point — for deep dives, follow the pointers to the reference files.

Reference Files — When to Read What

You're doing…	Read this
Organizing folders, naming assets, import settings	`references/project-structure.md`
Writing or reviewing C# scripts	`references/csharp-patterns.md`
Hunting a performance issue or optimizing	`references/performance.md`
Designing game architecture, patterns, systems	`references/architecture.md`
Setting up Git, testing, CI/CD, or building	`references/workflow.md`
Animation, 2D, Shader/VFX Graph	`references/specialized.md`
Debugging, localization, accessibility, AI/Inference Engine	`references/systems.md`
UI Toolkit or Cinemachine setup	`references/architecture-advanced.md`

Read the relevant reference before writing code — the patterns there will save you significant rework.