architecture-decision

Create Architecture Decision Records with context, alternatives, and consequences.

72|7|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill architecture-decision-striderza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/striderZA/OpenCodeGameStudios/tree/main/.opencode/skills/architecture-decision
Command: npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill architecture-decision-striderza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams document major technical decisions in a consistent Architecture Decision Record (ADR) format, including context, alternatives, dependencies, and consequences so engineering work stays aligned and reviewable.

Core Features & Use Cases

  • ADR authoring with guardrails: Guides you through engine context loading, architecture registry checks, and a structured ADR draft before writing.
  • Optional retrofit mode: Adds missing required sections to an existing ADR without modifying any present content, then prompts for re-validation.
  • Validation and integration workflow: Supports engine-specialist and technical-director review steps, then enforces GDD sync checks and (optionally) architecture registry updates.
  • Phase-gated coverage: Provides a closing workflow that steers you toward remaining priority ADRs or next design-system/GDD tasks.
  • No-regret safety constraints: Blocks contradictory architectural stances and requires explicit approval before registry changes.

Quick Start

Run the skill with a title like architecture-decision "event-system-architecture" to start drafting a new ADR with the required sections and review steps.

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 game engine architecture choices?▼

To create an Architecture Decision Record, provide a title to initiate engine context loading, architecture registry checks, and a structured ADR draft capturing context, alternatives, dependencies, and consequences for your game engine architecture.

What is included in an Architecture Decision Record for domain-specific system design?▼

An Architecture Decision Record includes context, alternatives, dependencies, and consequences for domain-specific system design. It enforces GDD traceability checks and engine-reference validation gates to ensure technical decisions respect prior stances and engine constraints.

Can I add missing sections to an existing Architecture Decision Record without changing the current content?▼

Yes, retrofit mode adds missing required sections to an existing Architecture Decision Record without modifying any present content. After adding sections, it prompts for re-validation through engine-reference and GDD sync checks.

How do Architecture Decision Records stay synchronized with a Game Design Document?▼

Architecture Decision Records stay synchronized with a Game Design Document through built-in GDD sync checks. The workflow enforces cross-GDD traceability during validation and optionally updates the architecture registry with user-approved new stances.

What happens if a new technical decision contradicts existing architectural stances in the registry?▼

Contradictory architectural stances are blocked by safety constraints. The workflow requires explicit user approval before making any architecture registry updates, ensuring no-regret decisions that respect prior stances and engine constraints.

Does the Architecture Decision Record workflow include technical review steps?▼

Yes, the Architecture Decision Record workflow supports engine-specialist and technical-director review steps. After validation, a phase-gated closing workflow directs you toward remaining priority ADRs or next design-system and GDD tasks.