skills.rest
FrancisVarga
FrancisVargaCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

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

Updated May 13, 2026
Search Tags:#game development#requirements traceability#adr#technical review#architecture decision#engine compatibility#gdd sync
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill architecture-decision-francisvarga
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/architecture-decision
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill architecture-decision-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

architecture-decision helps teams document significant technical decisions in a consistent Architecture Decision Record (ADR), so future developers can understand why choices were made and what trade-offs were accepted.

Core Features & Use Cases

  • Creates ADRs for major technical decisions: Ensures each major choice includes context, alternatives, consequences, and explicit traceability to requirements.
  • Supports normal authoring and safe retrofit mode: Can generate a new ADR or append missing required sections to an existing ADR without modifying existing content.
  • Validates against engine references and system constraints: Loads engine environment, checks domain risk and compatibility, consults architectural registry stances, and verifies GDD naming sync before writing.

Quick Start

Run the architecture-decision skill and provide a short title like event-system-architecture to generate the next ADR draft.

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 development?▼

You can create an Architecture Decision Record by running the skill with a short title like event-system-architecture. It generates an ADR draft capturing context, alternatives, dependencies, and consequences aligned with engine references.

What is an ADR and when do I need to document technical decisions?▼

An Architecture Decision Record (ADR) captures why significant technical choices were made and what trade-offs were accepted. You need an ADR when making major architectural decisions requiring future developer understanding and requirements traceability.

Can I update an existing ADR without modifying the current content?▼

Yes, safe retrofit mode appends missing required sections to an existing Architecture Decision Record without modifying existing content. Normal authoring mode generates entirely new ADR documents.

Does the ADR generation process validate engine compatibility and GDD sync?▼

ADR generation validates engine compatibility by loading engine environment references and checking domain risk. It also consults architectural registry stances and verifies Game Design Document (GDD) naming sync before writing output.

Where are Architecture Decision Records saved in the project directory?▼

Architecture Decision Records are written to the docs/architecture ADR path. The structured ADR output ensures consistent documentation placement for implementation readiness and future technical reviews.

Related Skills

Explore More Software Engineering Skills→
striderZAstriderZA
72

architecture-decision

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

Community
Advanced
axiomhqaxiomhq

validating-adr-compliance

Validate pull request changes against Architecture Decision Records for compliance.

Official
Intermediate
MichaelSolatiMichaelSolati

architecture-decision

Author and validate Architecture Decision Records against engine and GDD requirements.

Community
Advanced
adolfoaranaes12adolfoaranaes12
2

create-adr

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

Community
Advanced