architecture-decision

Document technical decisions in structured Architecture Decision Records.

Updated May 16, 2026
One-click install
npx skills add https://github.com/SeongHuni/LightNShadowSurviver --skill architecture-decision-seonghuni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/SeongHuni/LightNShadowSurviver/tree/main/GameStudio/codex/skills/architecture-decision
Command: npx skills add https://github.com/SeongHuni/LightNShadowSurviver --skill architecture-decision-seonghuni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill facilitates the creation of Architecture Decision Records (ADR) to document major technical decisions, their context, alternatives, and consequences, ensuring a structured approach to decision-making.

Core Features & Use Cases

  • ADR Creation: Generate an ADR for significant technical decisions.
  • Retrofit Mode: Update existing ADRs by adding missing sections.
  • Review Mode: Supports different review levels (full, lean, solo).
  • Engine Context: Load engine environment for accurate ADRs.
  • Collaborative Decision Making: Involve stakeholders in decision-making processes.
  • Validation: Ensures technical decisions align with architectural goals.

Quick Start

To create an ADR, invoke the skill with the desired title: /architecture-decision [title].

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I document a major technical decision using an Architecture Decision Record?

An Architecture Decision Record documents major technical decisions by capturing the context, alternatives, and consequences in a structured format. You can generate one by invoking the skill with a specific decision title.

Can I update an existing Architecture Decision Record to add missing context or alternatives?

Yes, you can update an existing Architecture Decision Record using retrofit mode. Retrofit mode analyzes existing records and automatically adds missing sections like context, alternatives, or consequences.

Does this Architecture Decision Record process support collaborative review with stakeholders?

Yes, the Architecture Decision Record process supports collaborative review through multiple modes. You can select full, lean, or solo review modes to involve stakeholders and align decisions with architectural goals.

What documentation do I need to create an Architecture Decision Record that aligns with my engine?

To create an aligned Architecture Decision Record, you need access to engine documentation and Game Design Documents (GDDs). The skill loads the engine environment to ensure technical decisions match architectural goals.

What is the best way to validate if a technical decision aligns with our architectural goals?

The best way to validate technical decisions is by generating an Architecture Decision Record. The process includes validation checks to ensure your chosen alternatives and consequences align with established architectural goals.

When should I use retrofit mode instead of creating a new Architecture Decision Record?

Use retrofit mode for an Architecture Decision Record when you have existing documentation that lacks structure. It updates records by adding missing sections, whereas standard creation builds a new ADR from scratch.