architecture-review

Validate architecture decisions against GDD technical requirements and engine compatibility.

72|7|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill architecture-review-striderza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/striderZA/OpenCodeGameStudios/tree/main/.opencode/skills/architecture-review
Command: npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill architecture-review-striderza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents architectural drift by validating that the project’s architecture decisions fully cover, consistently align with, and correctly support every technical requirement defined across the GDDs.

Core Features & Use Cases

  • Traceability and coverage validation: Builds a requirements traceability matrix mapping GDD technical requirements to ADRs, highlighting covered, partial, and missing items.
  • Consistency and conflict detection: Detects cross-ADR contradictions and reports conflict-prone areas to reduce rework risk.
  • Engine compatibility audit: Verifies that architectural decisions stay consistent with the pinned engine version and its documented constraints.
  • Optional RTM linkage (Production-ready): When stories and tests exist, extends traceability through to story and test evidence to support production gatekeeping.

Quick Start

Run the architecture-review with the full argument mode to audit the entire architecture against all GDDs and produce a PASS/CONCERNS/FAIL verdict.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I verify ADR coverage against GDD technical requirements before production?

To verify ADR coverage, build a traceability matrix mapping GDD technical requirements to ADRs, highlighting covered, partial, and missing items to produce a structured PASS, CONCERNS, or FAIL verdict.

What is a requirements traceability matrix for architecture review?

A requirements traceability matrix for architecture review maps GDD technical requirements to ADRs, and optionally to stories and tests, providing structured evidence of coverage and conflict detection for production gatekeeping.

How do I detect cross-ADR contradictions and conflicts in software architecture?

Detect cross-ADR contradictions by running consistency checks across architecture decisions, identifying conflict-prone areas to reduce rework risk and prevent architectural drift from GDD requirements.

Does the architecture review check compatibility with a pinned engine version?

Yes, the architecture review includes an engine compatibility audit that verifies architectural decisions stay consistent with the pinned engine version and its documented constraints.

Can I run a single-GDD review for focused architecture remediation?

Yes, run a single-GDD review for focused remediation by auditing architecture against one Game Design Document to extract technical requirements and validate coverage without checking the entire project scope.

What do I need to run an architecture gatekeeping audit for production?

Running architecture gatekeeping requires loading GDDs, ADRs, and engine reference docs, plus existing stories and tests to optionally extend the traceability matrix through to story and test evidence.