What problem does it solve?
The architecture-review skill verifies that the project's architecture (ADRs and architecture docs) fully and consistently satisfies the technical requirements expressed in Game Design Documents (GDDs), identifies coverage gaps, detects cross-ADR conflicts and dependency cycles, and confirms engine compatibility to prevent costly rework during implementation.
Core Features & Use Cases
- Requirements Traceability: Extracts technical requirements from GDDs, maps each to ADRs, and produces a traceability matrix showing covered, partial, and missing coverage.
- Conflict & Dependency Analysis: Detects data ownership, integration contract, performance, dependency, and state management conflicts across ADRs and outputs resolution options and a topologically sorted implementation order.
- Engine Compatibility Audit & RTM: Cross-checks ADR engine assumptions against engine reference docs and deprecated APIs, flags GDDs that need revision, and optionally generates a full Requirements Traceability Matrix linking requirements → ADR → story → test.
- Use Case: Technical directors performing a pre-production gate check to ensure foundation-level ADRs cover all GDD requirements and that no blocking ADR conflicts exist.
Quick Start
Run the architecture-review skill in full mode to generate a traceability matrix, identify ADR coverage gaps and conflicts, and produce a PASS/CONCERNS/FAIL verdict.
