unity-adr

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

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-adr-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-adr
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/adr
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-adr-darth-carrotpie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When building Unity projects, teams repeatedly face architecture choices—Coroutine vs UniTask, direct references vs event-driven communication, one assembly vs multiple asmdefs—and the reasoning behind those choices is often lost, causing the same debates to resurface later. ## Core Features & Use Cases - Structured ADR Format: Produces a consistent record covering Decision, Context, Options considered, Chosen option, Why this option won, Consequences, and Revisit triggers. - Unity-Specific Scenarios: Covers common Unity tradeoffs such as ScriptableObject config vs in-scene authoring and MonoBehaviour vs pure C# services. - Use Case: When a developer asks whether to use UniTask or coroutines for async logic, the Skill compares both options, weighs tradeoffs, and locks in a documented decision with rationale that the team can revisit later. ## Quick Start Ask the agent to record an architecture decision comparing two Unity approaches, such as "help me decide between event-driven communication and direct references and document the decision."

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 structured record when you describe the choice you are evaluating.

When should I write an ADR for Unity code?▼

Write an ADR when multiple plausible technical options exist or when a decision may be revisited later, such as choosing between Coroutine and UniTask or between one assembly and multiple asmdefs. Skip ADRs for trivial choices that do not affect architecture direction.

What Unity decisions does an ADR typically cover?▼

Typical Unity ADRs cover Coroutine vs UniTask, direct reference vs event-driven communication, ScriptableObject config vs in-scene authoring, single vs multiple asmdef assemblies, and MonoBehaviour vs pure C# services.

Does this Skill generate code or only documentation?▼

It is documentation only. The Skill produces a written decision record with options and rationale and does not generate or modify any Unity code, so it can be loaded freely under any operating mode.

What are the limitations of using ADRs for decision tracking?▼

ADRs only capture decisions at the time they are written and do not enforce them in code. They should stay short and focus on decisions that materially affect architecture, otherwise the record becomes noise that teams stop reading.