skills.rest
imgamer
imgamerCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

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

Updated Dec 22, 2024
Search Tags:#adr#technical review#architecture decision record#engine compatibility#retrofit mode#gdd integration#architecture registry
One-click install
npx skills add https://github.com/imgamer/AILearn --skill architecture-decision-imgamer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/architecture-decision
Command: npx skills add https://github.com/imgamer/AILearn --skill architecture-decision-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

architecture-decision helps you document major technical decisions in a consistent Architecture Decision Record (ADR) format, including context, alternatives, dependencies, and consequences so teams can build and review implementations with shared understanding.

Core Features & Use Cases

  • ADR authoring with engine-aware compatibility: Loads engine reference docs, flags post-cutoff risks, and includes a structured Engine Compatibility section.
  • Collaborative, gate-based workflow: Guides assumptions, coordinates engine-specialist and technical-director reviews (depending on review mode), and performs GDD sync checks.
  • Retrofit existing ADRs safely: Adds only missing required sections (never modifies existing content) when converting older ADRs into the required template.
  • Architecture registry integration (optional): Proposes new stances to append to docs/registry/architecture.yaml after the ADR is written, with explicit user approval.

Quick Start

Ask the skill to create an ADR by running: invoke architecture-decision with the title for your decision, for example "event-system-architecture".

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I write an Architecture Decision Record that captures technical context and consequences?▼

An Architecture Decision Record captures technical decision context, alternatives, dependencies, and consequences. This skill enforces template completeness with gated reviews to document major technical choices for team alignment.

Can I upgrade existing ADR files to a new template without losing previous content?▼

Yes, retrofit mode safely converts older ADR files by adding only missing required sections. It never modifies existing content, ensuring your previous technical decisions remain intact during the template upgrade.

How do I check engine compatibility when authoring an ADR?▼

Engine compatibility is validated by loading engine reference and version docs into the workflow. The skill flags post-cutoff risks and generates a structured Engine Compatibility section within the ADR.

What is the best way to align architecture decisions with the Game Design Document?▼

GDD integration validates interface naming against the Game Design Document during the review process. The skill performs GDD sync checks to ensure architecture decisions align with game design specifications.

How does a gated review workflow work for architecture decision records?▼

The gated review workflow coordinates engine-specialist and technical-director reviews based on the selected review mode. It guides assumptions and validates template completeness before the ADR is written to the architecture directory.

Do I need a separate architecture registry when creating an Architecture Decision Record?▼

An architecture registry is optional. After writing the ADR, the skill can propose new stances to append to docs/registry/architecture.yaml, but this requires explicit user approval before any registry integration occurs.

Related Skills

Explore More Software Engineering Skills→
imclabimclab
1

architecture-decision

Create Architecture Decision Records with YAML frontmatter and engine compatibility validation.

Official
Advanced
686f6c61686f6c61
105

write-adr

Generate Architecture Decision Records documenting context, alternatives, decision, and consequences.

Community
Intermediate
polsegupolsegu

architecture-decision

Create Architecture Decision Records with engine compatibility validation and registry updates.

Community
Advanced
nuoyanruoshuinuoyanruoshui
47

architecture-decision

Document technical decisions as structured Architecture Decision Records with context and alternatives.

Community
Advanced