unity-adr

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

Updated May 20, 2026
One-click install
npx skills add https://github.com/yuse168/Roomies --skill unity-adr-yuse168
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-adr
Source: https://github.com/yuse168/Roomies/tree/main/.agents/skills/unity-skills/skills/adr
Command: npx skills add https://github.com/yuse168/Roomies --skill unity-adr-yuse168

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When building Unity projects, teams repeatedly face technical choices—Coroutine vs UniTask, direct references vs event-driven communication, one assembly vs multiple asmdefs—without a record of why a decision was made. This Skill captures those architecture decisions in a consistent ADR format so the reasoning survives team changes and future refactors. ## Core Features & Use Cases - Structured ADR Output: Produces a decision record with Decision, Context, Options considered, Chosen option, Rationale, 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: You are debating whether to use UniTask or coroutines for async logic in a Unity project. Ask for an ADR and receive a concise record comparing both options, stating the winner, and noting when to revisit the choice. ## Quick Start Ask the assistant to write an ADR comparing Coroutine and UniTask for your Unity project's async logic and record the chosen approach with its rationale.

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.

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

The choice depends on your project's async needs, and this Skill helps you weigh both options and record the outcome. It produces an ADR comparing tradeoffs so the decision and its reasoning are preserved for the team.

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

Write an ADR when multiple plausible options exist or the choice may be revisited later, such as event-driven vs direct references or one assembly vs multiple asmdefs. Only record decisions that materially affect code generation or architecture direction.

Does this Skill modify Unity project code or require special permissions?▼

No, it is documentation-only and generates no code changes. It loads freely under any operating mode including Approval, Auto, or Bypass, since it only produces decision records.

What are the limitations of ADR documentation for small decisions?▼

ADRs add overhead when applied to trivial choices, so they should stay short and cover only decisions affecting architecture direction. Minor implementation details that can be easily reversed do not need a formal record.