skills.rest
claretagrapelike32
claretagrapelike32COMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

Creates Architecture Decision Records documenting technical decisions, alternatives, and consequences for game projects.

Updated Aug 2, 2026
Search Tags:#game development#adr#registry#technical documentation#architecture decision#engine compatibility#design record
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill architecture-decision-claretagrapelike32
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/architecture-decision
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill architecture-decision-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Major technical decisions in game development often go undocumented, leading to inconsistent implementations, contradictory designs, and lost context when team members change. This Skill produces structured Architecture Decision Records (ADRs) that capture the context, alternatives, and consequences of every significant technical choice. ## Core Features & Use Cases - Guided ADR Authoring: Walks through problem framing, alternatives analysis, dependency mapping, and GDD traceability using a standardized ADR template with engine compatibility tables. - Retrofit Mode: Scans existing ADR files for missing sections (Status, ADR Dependencies, Engine Compatibility, GDD Requirements) and appends only the absent sections without modifying existing content. - Registry & Consistency Gates: Checks an architecture registry for conflicting stances, validates drafts with engine specialist and technical director reviews, and detects GDD naming inconsistencies before writing. - Use Case: A team deciding between an event bus and direct signal connections for their Godot project runs this Skill to produce ADR-0003 with verified engine API references, registered interface contracts, and links to the GDD systems it satisfies. ## Quick Start Ask the AI to create an architecture decision record for your technical choice, for example by saying: use the architecture-decision skill to document our event system architecture decision.

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I create an Architecture Decision Record for a game project?▼

Invoke the skill with a short decision title, and it guides you through confirming assumptions about the problem, alternatives, and dependencies before drafting a full ADR. The output follows a standard template with Status, Engine Compatibility, Alternatives Considered, and Consequences sections.

What is ADR retrofit mode and how does it work?▼

Retrofit mode updates existing ADR files that are missing required sections. Pass 'retrofit' followed by the file path, and the skill scans for absent sections like Status or ADR Dependencies, then appends only the missing parts without modifying existing content.

Does this skill work with Godot, Unity, and Unreal Engine?▼

Yes, it reads engine reference docs under docs/engine-reference for whichever engine is configured, checking version-specific breaking changes and deprecated APIs. If no engine is configured, it prompts you to run the setup-engine skill first.

How does the skill prevent contradictory architecture decisions?▼

It reads docs/registry/architecture.yaml before drafting and surfaces any registered stances, interface contracts, or forbidden patterns that conflict with the proposed decision. Conflicts must be resolved, explicitly superseded, or accepted as exceptions before drafting continues.

What are the review modes and when are reviews skipped?▼

Three modes exist: solo and lean skip the Technical Director review gate, while full spawns both an engine specialist validation and a technical director strategic review. The mode is set via a --review flag or read from production/review-mode.txt, defaulting to lean.

Related Skills

Explore More Software Engineering Skills→
wanghaishengwanghaisheng
10

setup-engine

Configure a project's game engine and version with guided selection and documentation updates.

Community
Advanced
nuoyanruoshuinuoyanruoshui
47

architecture-review

Validate architectural coverage and consistency against game design requirements and ADRs.

Community
Advanced
MichaelSolatiMichaelSolati

create-epics

Generate bounded, module-specific epics from approved game design documents and system architecture.

Community
Advanced
zoraxlzoraxl
3

wiki-adr

Create standardized architecture decision records within a structured wiki-zone hierarchy.

Community
Intermediate