architecture-review

Validate game architecture decisions against GDD technical requirements and engine version.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill architecture-review-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/architecture-review
Command: npx skills add https://github.com/imgamer/AILearn --skill architecture-review-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures your game project architecture decisions fully and consistently cover every technical requirement defined across all GDDs, and that they remain compatible with the pinned engine version.

Core Features & Use Cases

  • Completeness validation: Checks whether architectural decision records (ADRs) cover all GDD technical requirements, producing a PASS/CONCERNS/FAIL verdict.
  • Traceability matrix generation: Builds a traceability matrix mapping GDD technical requirements to ADRs, highlighting gaps and partial coverage.
  • Conflict and compatibility audits: Detects cross-ADR conflicts (including dependency ordering and integration contracts) and verifies engine compatibility consistency across decisions.
  • Focused review options: Supports targeted modes like coverage-only, consistency-only, engine-only, single-GDD review, and RTM output for story/test linkage.

Quick Start

Use the architecture-review skill in full mode to validate architecture coverage, consistency, and engine compatibility across the entire project.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I validate that my game architecture decisions cover all GDD technical requirements?

Architecture validation checks whether your architectural decision records fully cover all technical requirements defined in game design documents, producing a PASS, CONCERNS, or FAIL verdict. It builds a traceability matrix mapping requirements to ADRs and highlights any gaps or partial coverage.

How do I detect conflicts between architectural decision records in a game project?

Conflict detection audits cross-ADR conflicts, including dependency ordering and integration contract issues, to ensure architectural decisions remain consistent. It cross-checks decisions against each other and verifies engine compatibility consistency across all records.

What is a requirements traceability matrix for game pre-production and when do I need one?

A requirements traceability matrix maps GDD technical requirements to ADRs to verify complete architectural coverage. You need it during pre-production architecture quality gating to highlight gaps, and optionally to generate RTM artifacts linking requirements to stories and tests for production.

Can I review engine compatibility for a single GDD without auditing the entire project architecture?

Yes, you can use focused review modes like engine-only, coverage-only, consistency-only, or single-GDD review. These targeted modes allow you to verify engine compatibility consistency or check individual game design documents without running full project validation.

How do I generate an RTM linking requirements to stories and tests for game production?

You can generate an optional requirements-to-stories-to-tests RTM during architecture review by selecting the RTM output mode. This produces artifacts that link GDD technical requirements and ADRs to production stories and tests, extending pre-production traceability into the production phase.

Why does my game architecture review return a CONCERNS verdict instead of PASS?

A CONCERNS verdict indicates partial coverage or minor inconsistencies between ADRs and GDD technical requirements. The review outputs detailed reports highlighting gaps, cross-ADR conflicts, dependency ordering issues, or engine compatibility mismatches that prevent a full PASS verdict.