Unity
Ship on the default stack below. Each row names the one tool to reach for,
so the choice is already made — spend the thinking on the feature instead.
Baseline: 6.7 LTS, written CoreCLR-ready. 6.7 LTS is the last Mono
release; 6.8 removes Mono and moves the Editor and desktop player to CoreCLR on
.NET 10 / C# 14. Unity 7 (Q1 2027) continues that line rather than breaking it —
a CoreCLR-ready project reaches it with little extra work, which is what the
discipline in runtime.md buys.
The default stack
| Need |
Reach for |
Instead of |
| Any new UI |
UI Toolkit — ui.md |
UGUI |
| World-space / diegetic UI |
Panel Renderer (6.5) |
UGUI world canvas, render texture |
| Text |
Advanced Text Generator (default 6.5) |
hand-rolled layout |
| Authoring UI for a custom tool |
UI Toolkit — editor-tools.md |
Odin, IMGUI, a node canvas |
| Heterogeneous items in one authored list |
[SerializeReference] + AdvancedDropdown |
one list per type |
| Tool icons |
Built-in Editor icons, then painter2D |
shipping PNG variants per state |
| Async |
Awaitable + CancellationToken |
coroutines, raw Task |
| Runtime loading |
Addressables + AssetReference |
Resources/ |
| Input |
Input System action maps |
legacy Input Manager |
| Audio |
built-in AudioMixer — workflow.md |
FMOD/Wwise |
| Render pipeline |
URP — rendering.md |
Built-In, HDRP |
| Custom render passes |
Render Graph |
ScriptableRenderPass.Execute |
| Lighting, static scenes |
Adaptive Probe Volumes + baked lightmaps |
Light Probe Groups |
| Light baking |
Unity Compute Light Baker |
every other light-baking backend |
| Lighting, dynamic scenes |
Surface Cache GI (6.7) |
baking a scene that moves |
| Draw-call reduction |
GPU Resident Drawer + GPU occlusion |
static and dynamic batching |
| Pooling |
UnityEngine.Pool |
hand-rolled pools |
| Object identity |
EntityId (64-bit) |
GetInstanceID(), int ids |
| Hot paths |
Jobs + Burst |
a full ECS rewrite |
| Netcode |
Netcode for GameObjects |
Netcode for Entities |
| Authority |
client-server |
distributed authority |
| Sessions, matchmaking, relay |
Multiplayer Services |
Lobby + Matchmaker + Relay separately |
| Server builds |
Dedicated Server + Multiplayer Roles |
a hand-stripped client build |
| Testing multiple peers |
Multiplayer Play Mode |
several Editor installs |
| Per-platform build config |
Build Profiles |
hand-edited global Build Settings |
| Tests |
Unity Test Framework, edit-mode first |
play-mode by default |
| Release builds |
IL2CPP |
Mono in shipping builds |
| Driving the Editor from an agent |
Unity CLI — cli.md |
asking the user to click through the Editor |
Leave a default only where the linked reference gives that row an escape hatch.
Say which row you left and what made it worth leaving.
Reference
| Topic |
File |
CoreCLR readiness, static state, serialization, EntityId |
runtime.md |
| Unity CLI, driving the Editor from an agent, screen captures, why not MCP |
cli.md |
| UI Toolkit, design tokens, data binding, MVP |
ui.md |
Custom Editor tools, inspectors, [SerializeReference] |
editor-tools.md |
Composition, asmdefs, Awaitable, Jobs/Burst/ECS, profiling, allocations |
architecture.md |
Exceptions, nullability, async void, the UnityEngine.Object null trap |
code-standards.md |
| Folder layout, naming, GUID-safe renames |
project-structure.md |
| Addressables, import presets, scenes, prefabs |
assets.md |
| Pipeline, lighting, GPU-driven rendering |
rendering.md |
| Input, audio, version control, CI, builds, testing |
workflow.md |
| Netcode, authority, sessions, dedicated server |
multiplayer.md |
For Figma designs as UI Toolkit interfaces, use the figma-to-unity skill. For
engine-agnostic replication theory, use coop-session.
Review pass
Read changed code against every row of the default stack, then account for each
line below — name the file and line where it holds, or fix it:
Several rows are conditional: they bind only when the change performs the
operation they describe. "Not applicable, this change does not do that" is a
complete answer, and the right one. Test the condition, never the presence of a
token — and never infer the rule from how many neighbouring files show the same
pattern, since copy-paste propagates a mistake as reliably as a convention.
- [ ] Statics reset explicitly, so entering Play Mode twice behaves identically
- [ ] Every Awaitable carries a CancellationToken scoped to its component
- [ ] Assets load through Addressables, and every handle is released
- [ ] Update() free of allocation, GetComponent, Find*, and LINQ
- [ ] Runtime spawns come from a pool
- [ ] Object identity flows through EntityId
- [ ] [SerializeField] on fields only ([field: SerializeField] for properties)
- [ ] Logic sits in plain C# in its own asmdef, covered by edit-mode tests
- [ ] Renamed assets moved with their .meta, via git mv
- [ ] Networked state gated on HasAuthority
- [ ] Editor code under an Editor asmdef, runtime types in runtime assemblies
- [ ] Any rename or move of a [SerializeReference] type in this change lands with [MovedFrom] naming its real former address (no former address, no attribute)
- [ ] Custom inspectors built on UI Toolkit, with IMGUIContainer only where named
When the user asks for something off the default stack, name the row, state what
it costs, and follow their call.
1---2name: unity3description: Picks the Unity tool for the job and applies it. Routes each need to one chosen default — UI Toolkit, Awaitable, Addressables, Input System, URP, Netcode for GameObjects, Multiplayer Services, Dedicated Server, Unity CLI — and keeps the project CoreCLR-ready for the Mono removal in 6.8. Use when writing, reviewing, or architecting Unity code, when building a custom Editor tool or inspector, when driving the Unity Editor from an agent, when choosing between two Unity tools that do the same job, or when the user mentions Unity, UI Toolkit, UGUI, Addressables, URP, HDRP, DOTS, ECS, netcode, custom inspector, SerializeReference, CoreCLR, IL2CPP, Unity CLI, Unity MCP, or Unity build and performance questions.4---56# Unity78Ship on the **default stack** below. Each row names the one tool to reach for,9so the choice is already made — spend the thinking on the feature instead.1011Baseline: **6.7 LTS**, written **CoreCLR-ready**. 6.7 LTS is the last Mono12release; 6.8 removes Mono and moves the Editor and desktop player to CoreCLR on13.NET 10 / C# 14. Unity 7 (Q1 2027) continues that line rather than breaking it —14a CoreCLR-ready project reaches it with little extra work, which is what the15discipline in [runtime.md](./runtime.md) buys.1617## The default stack1819| Need | Reach for | Instead of |20| --- | --- | --- |21| Any new UI | **UI Toolkit** — [ui.md](./ui.md) | UGUI |22| World-space / diegetic UI | **Panel Renderer** (6.5) | UGUI world canvas, render texture |23| Text | **Advanced Text Generator** (default 6.5) | hand-rolled layout |24| Authoring UI for a custom tool | **UI Toolkit** — [editor-tools.md](./editor-tools.md) | Odin, IMGUI, a node canvas |25| Heterogeneous items in one authored list | **`[SerializeReference]`** + `AdvancedDropdown` | one list per type |26| Tool icons | **Built-in Editor icons**, then `painter2D` | shipping PNG variants per state |27| Async | **`Awaitable`** + `CancellationToken` | coroutines, raw `Task` |28| Runtime loading | **Addressables** + `AssetReference` | `Resources/` |29| Input | **Input System** action maps | legacy Input Manager |30| Audio | **built-in AudioMixer** — [workflow.md](./workflow.md) | FMOD/Wwise |31| Render pipeline | **URP** — [rendering.md](./rendering.md) | Built-In, HDRP |32| Custom render passes | **Render Graph** | `ScriptableRenderPass.Execute` |33| Lighting, static scenes | **Adaptive Probe Volumes** + baked lightmaps | Light Probe Groups |34| Light baking | **Unity Compute Light Baker** | every other light-baking backend |35| Lighting, dynamic scenes | **Surface Cache GI** (6.7) | baking a scene that moves |36| Draw-call reduction | **GPU Resident Drawer** + GPU occlusion | static and dynamic batching |37| Pooling | **`UnityEngine.Pool`** | hand-rolled pools |38| Object identity | **`EntityId`** (64-bit) | `GetInstanceID()`, `int` ids |39| Hot paths | **Jobs + Burst** | a full ECS rewrite |40| Netcode | **Netcode for GameObjects** | Netcode for Entities |41| Authority | **client-server** | distributed authority |42| Sessions, matchmaking, relay | **Multiplayer Services** | Lobby + Matchmaker + Relay separately |43| Server builds | **Dedicated Server** + Multiplayer Roles | a hand-stripped client build |44| Testing multiple peers | **Multiplayer Play Mode** | several Editor installs |45| Per-platform build config | **Build Profiles** | hand-edited global Build Settings |46| Tests | **Unity Test Framework**, edit-mode first | play-mode by default |47| Release builds | **IL2CPP** | Mono in shipping builds |48| Driving the Editor from an agent | **Unity CLI** — [cli.md](./cli.md) | asking the user to click through the Editor |4950Leave a default only where the linked reference gives that row an escape hatch.51Say which row you left and what made it worth leaving.5253## Reference5455| Topic | File |56| --- | --- |57| CoreCLR readiness, static state, serialization, `EntityId` | [runtime.md](./runtime.md) |58| Unity CLI, driving the Editor from an agent, screen captures, why not MCP | [cli.md](./cli.md) |59| UI Toolkit, design tokens, data binding, MVP | [ui.md](./ui.md) |60| Custom Editor tools, inspectors, `[SerializeReference]` | [editor-tools.md](./editor-tools.md) |61| Composition, asmdefs, `Awaitable`, Jobs/Burst/ECS, profiling, allocations | [architecture.md](./architecture.md) |62| Exceptions, nullability, `async void`, the `UnityEngine.Object` null trap | [code-standards.md](./code-standards.md) |63| Folder layout, naming, GUID-safe renames | [project-structure.md](./project-structure.md) |64| Addressables, import presets, scenes, prefabs | [assets.md](./assets.md) |65| Pipeline, lighting, GPU-driven rendering | [rendering.md](./rendering.md) |66| Input, audio, version control, CI, builds, testing | [workflow.md](./workflow.md) |67| Netcode, authority, sessions, dedicated server | [multiplayer.md](./multiplayer.md) |6869For Figma designs as UI Toolkit interfaces, use the `figma-to-unity` skill. For70engine-agnostic replication theory, use `coop-session`.7172## Review pass7374Read changed code against every row of the default stack, then account for each75line below — name the file and line where it holds, or fix it:7677Several rows are conditional: they bind only when the change performs the78operation they describe. "Not applicable, this change does not do that" is a79complete answer, and the right one. Test the condition, never the presence of a80token — and never infer the rule from how many neighbouring files show the same81pattern, since copy-paste propagates a mistake as reliably as a convention.8283```84- [ ] Statics reset explicitly, so entering Play Mode twice behaves identically85- [ ] Every Awaitable carries a CancellationToken scoped to its component86- [ ] Assets load through Addressables, and every handle is released87- [ ] Update() free of allocation, GetComponent, Find*, and LINQ88- [ ] Runtime spawns come from a pool89- [ ] Object identity flows through EntityId90- [ ] [SerializeField] on fields only ([field: SerializeField] for properties)91- [ ] Logic sits in plain C# in its own asmdef, covered by edit-mode tests92- [ ] Renamed assets moved with their .meta, via git mv93- [ ] Networked state gated on HasAuthority94- [ ] Editor code under an Editor asmdef, runtime types in runtime assemblies95- [ ] Any rename or move of a [SerializeReference] type in this change lands with [MovedFrom] naming its real former address (no former address, no attribute)96- [ ] Custom inspectors built on UI Toolkit, with IMGUIContainer only where named97```9899When the user asks for something off the default stack, name the row, state what100it costs, and follow their call.
Firzus