architecture-review

Validate architecture decisions against GDD requirements and engine compatibility.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/scomofo/dragon-forge --skill architecture-review-scomofo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/scomofo/dragon-forge/tree/main/.agents/skills/architecture-review
Command: npx skills add https://github.com/scomofo/dragon-forge --skill architecture-review-scomofo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents architectural drift by validating that the project’s ADR set fully and consistently satisfies every technical requirement stated across the GDDs, including engine compatibility alignment.

Core Features & Use Cases

  • Architecture coverage validation: Produces a requirements → ADR coverage matrix to surface gaps and partial implementations.
  • Cross-ADR consistency checks: Detects contradictions across ADRs (ownership, integration contracts, performance budgets, dependencies, and state authority).
  • Engine compatibility audit: Verifies ADR engine version consistency and flags deprecated or stale API assumptions.

Quick Start

Run the architecture review in full mode to validate completeness, consistency, and engine compatibility across all GDDs and ADRs, then generate a PASS/CONCERNS/FAIL verdict report with coverage gaps and conflicts.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I check if my ADRs cover all technical requirements in my GDDs?

To check ADR coverage against GDDs, you need a traceability matrix that maps every technical requirement to its corresponding architecture decision record. This review process extracts requirements into a registry and generates a coverage report to surface gaps or partial implementations across your project.

What is the best way to detect conflicts between architecture decision records?

Detecting cross-ADR conflicts requires consistency checks across ownership, integration contracts, performance budgets, dependencies, and state authority. An architecture review identifies contradictions between decision records to prevent architectural drift and ensure project-wide consistency before production.

How do I validate Godot 4 engine compatibility in my architecture decisions?

Validating Godot 4 engine compatibility involves auditing ADRs against engine reference docs to verify version consistency. An architecture review flags deprecated or stale API assumptions in your decision records to ensure your technical design aligns with the engine's current capabilities.

Can I generate a pre-production readiness verdict for a Godot-based system?

Yes, you can generate a pre-production readiness verdict by running a full architecture review across your GDDs and ADRs. The process outputs a structured PASS, CONCERNS, or FAIL verdict report detailing coverage gaps, conflicts, and engine compatibility issues for your Godot-based system.

When do I need an architecture traceability matrix for my game design document?

You need an architecture traceability matrix when your game design document contains technical requirements that must be fulfilled by architecture decisions. It ensures every requirement is addressed by an ADR, preventing architectural drift during the transition from design to pre-production.

Does architecture review work without loading engine reference docs?

No, engine reference docs are required alongside GDDs and ADRs to perform a complete architecture review. Loading these documents is necessary to extract technical requirements, build coverage reports, and accurately flag deprecated or stale API assumptions for engine compatibility audits.