📐
WritingShell

Architecture Decision

by Donchitos

Architecture Decision is a Writing skill for Claude Code, published by Donchitos in Claude-Code-Game-Studios.

23.9K stars3.4K forkson Donchitos/Claude-Code-Game-StudiosAdded 2026/08/14Repository updated 2026/05/21
ai-agentsai-assisted-developmentanthropicclaudeclaude-codegame-designgame-developmentgamedevgodotindie-game-devunityunreal-engine
Install in seconds
Install Architecture Decision
Copy Architecture Decision into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/Donchitos/Claude-Code-Game-Studios/tree/main/.claude/skills/architecture-decision ~/.claude/skills/architecture-decision

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.claude/skills/architecture-decision/SKILL.md in Donchitos/Claude-Code-Game-Studios
Installs to
~/.claude/skills/architecture-decision
Collection
One of 25 skills cataloged from this repository
Category
Writing1012 skills

What Architecture Decision does

Architecture Decision creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives considered, and consequences. Use it when every major technical choice should have a formal, validated ADR in a game development project.

Architecture Decision is cataloged under Writing on DirSkills. Architecture Decision comes from a repository tagged ai-agents, ai-assisted-development, anthropic, claude and claude-code.

Documentation

README

When this skill is invoked:

0. Parse Arguments — Detect Retrofit Mode

Resolve the review mode (once, store for all gate spawns this run):

  1. If --review [full|lean|solo] was passed → use that
  2. Else read production/review-mode.txt → use that value
  3. Else → default to lean

See .claude/docs/director-gates.md for the full check pattern.

If the argument starts with retrofit followed by a file path (e.g., /architecture-decision retrofit docs/architecture/adr-0001-event-system.md):

Enter retrofit mode:

This is the opening of the README. Read the full README on GitHub.

Commands Architecture Decision provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /architecture-decision
  • /story-readiness
  • /architecture-review
  • /setup-engine
  • /design-system

Frequently asked about Architecture Decision

  • What else does Donchitos publish alongside Architecture Decision?

    Architecture Decision is one of 25 skills that DirSkills catalogs from Donchitos/Claude-Code-Game-Studios, the repository it ships in. Its siblings there include Adopt, Architecture Review and Art Bible. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decision does, and is maintained by Donchitos in that same repository. The rest of the collection is listed on the Donchitos/Claude-Code-Game-Studios page.

  • How does Architecture Decision compare to other Writing skills?

    Architecture Decision ranks #61 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Decision against them. Open each page to compare what they document and how they install.

More from Donchitos/Claude-Code-Game-Studios

Architecture Decision is one of 25 skills cataloged on DirSkills from Donchitos/Claude-Code-Game-Studios.

See all 25 skills
🔍
2w ago

Adopt

Adopt audits a brownfield project's existing artifacts against the template's required internal formats, classifies gaps by impact, and produces a numbered migration plan. Use it when joining an in-progress project or upgrading from an older template version.
Quality
23.9K3.4K
🏛️
2w ago

Architecture Review

Architecture Review validates that architectural decisions cover all game design requirements, are internally consistent, and target the correct engine version. It builds a traceability matrix, detects cross-ADR conflicts, and produces a PASS/CONCERNS/FAIL verdict.
Quality
23.9K3.4K
🎨
2w ago

Art Bible

Art Bible guides section-by-section authoring of a game's visual identity specification, which gates all asset production. Use it after the game concept is approved and before any game design document authoring.
Writing
23.9K3.4K
🔍
2w ago

Asset Audit

Asset Audit scans game asset directories to check naming conventions, file size budgets, format standards, and pipeline requirements. Use it to identify orphaned assets, missing references, and standard violations before release.
Quality
23.9K3.4K
🎨
2w ago

Asset Spec

Asset Spec generates per-asset visual specifications and AI generation prompts from game design documents, level docs, or character profiles. Use it after the art bible and GDD/level design are approved, before production begins.
AI Engineering
23.9K3.4K
⚖️
2w ago

Balance Check

Balance Check analyzes game balance data files, formulas, and configuration to identify outliers, broken progressions, degenerate strategies, and economy imbalances. Use it after modifying any balance-related data or design.
Data
23.9K3.4K