unity-adr

Records Unity architecture decisions with rationale, options, and consequences.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-adr-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-adr
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/adr
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-adr-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture choices in Unity projects are often revisited months later with no record of why a particular approach was chosen, leading to repeated debates and inconsistent code. This Skill captures those decisions in a structured Architecture Decision Record (ADR) format so the reasoning stays with the project. ## 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 Scenarios: Tailored to common Unity trade-offs 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 between a single assembly and multiple asmdef files for a growing Unity codebase, use this Skill to document the options weighed, the final choice, and the conditions under which the decision should be revisited. ## Quick Start Ask the assistant to record an ADR for your Unity decision, for example: document why we chose UniTask over Coroutines for async logic in this project.

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 (ADR) that captures the decision, context, options considered, chosen option, rationale, consequences, and revisit triggers. This Skill generates that structure for Unity-specific choices like async patterns or assembly layout.

When should I write an ADR for Unity code?

Write an ADR when multiple plausible options exist or when a choice may be revisited later, such as Coroutine vs UniTask or one assembly vs multiple asmdef files. Keep ADRs short and only record decisions that materially affect code generation or architecture direction.

What should a Unity ADR include?

A Unity ADR should include the decision statement, context, options considered, the chosen option, why it won, consequences, and revisit triggers. This keeps the record concise while preserving the reasoning behind the choice.

Does this ADR skill modify my Unity project files?

No, it is documentation only and does not execute REST skills or modify project code. It can be loaded freely under any operating mode including Approval, Auto, or Bypass.

What are the limitations of ADR documentation?

ADRs only capture decisions at a point in time and do not enforce them in code. They add overhead if overused, so record only decisions that materially affect architecture direction rather than every minor implementation choice.