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.