unity-adr

Documents Unity architecture decisions with options, tradeoffs, and rationale.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-adr-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-adr
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills/skills/adr
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-adr-dylan8865

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity projects often revisit technical choices without a record of why a particular approach was chosen, leading to repeated debates and inconsistent architecture. This Skill captures architecture decisions in a structured ADR format so the reasoning behind each choice is preserved. ## Core Features & Use Cases - Structured ADR Output: Produces a consistent record covering Decision, Context, Options considered, Chosen option, Rationale, Consequences, and Revisit triggers. - Unity-Specific Decision Support: Covers common Unity tradeoffs such as Coroutine vs UniTask, direct references vs event-driven communication, ScriptableObject config vs in-scene authoring, and MonoBehaviour vs pure C# services. - Use Case: When deciding whether to split game code into multiple asmdef assemblies, use this Skill to compare the options, weigh compile-time and dependency tradeoffs, and lock in the decision with documented rationale. ## Quick Start Ask the assistant to record an ADR comparing Coroutine and UniTask for your Unity project's async logic.

Frequently Asked Questions about unity-adr

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

FAQPage Schema
How do I document architecture decisions in a Unity project?▼

Use an Architecture Decision Record that captures the decision, context, options considered, chosen option, rationale, consequences, and revisit triggers. Keep each ADR short and focused on one decision that materially affects code or architecture.

Coroutine vs UniTask: which should I use in Unity?▼

The choice depends on your project's async needs, allocation concerns, and dependency tolerance. An ADR helps you compare both options against your context, record the tradeoffs, and document why the chosen approach won.

When should I write an ADR for a Unity design decision?▼

Write an ADR when multiple plausible options exist or when a choice may be revisited later, such as event-driven vs direct references or single vs multiple asmdef assemblies. Skip ADRs for trivial decisions that do not affect architecture direction.

What should a good architecture decision record include?▼

A good ADR includes the decision statement, context, options considered, the chosen option, why it won, consequences, and revisit triggers. It should stay short and record only decisions that materially affect code generation or architecture.

Does this skill generate or modify Unity code?▼

No, it is documentation-only and produces ADR text records. It does not execute scripts, call APIs, or modify project files, so it can be loaded freely under any operating mode.