architecture-review

Validate game architecture against design documents and generate traceability reports.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill architecture-review-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/architecture-review
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill architecture-review-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill ensures that a project's architecture comprehensively covers all game design requirements, maintaining internal consistency and alignment with the chosen engine before moving into production.

Core Features & Use Cases

  • Phase‑guided review: Loads GDDs, ADRs, engine references, and standards, then extracts technical requirements.
  • Traceability matrix generation: Maps each requirement to ADRs, stories, and tests, highlighting coverage gaps.
  • Cross‑ADR conflict detection: Identifies contradictory decisions, dependency cycles, and performance budget clashes.
  • Engine compatibility audit: Verifies version consistency, deprecated API usage, and post‑cutoff API assumptions.
  • Comprehensive report: Delivers a verdict (PASS/CONCERNS/FAIL) with actionable recommendations for ADR creation and GDD revisions.

Quick Start

Invoke the architecture-review skill with the argument full to perform a complete review.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I validate game architecture against GDD requirements?

To validate game architecture against GDD requirements, extract technical requirements from design documents and map them to ADRs, generating a traceability matrix that highlights coverage gaps and ensures completeness before production.

How do I detect conflicts between ADRs during pre-production?

Detect cross-ADR conflicts during pre-production by analyzing architecture decisions for contradictory logic, dependency cycles, and performance budget clashes, producing a conflict report to resolve inconsistencies early.

What is an architecture traceability matrix for game development?

An architecture traceability matrix for game development maps each GDD requirement to corresponding ADRs, stories, and tests, ensuring all design specifications are covered and identifying gaps in technical documentation.

How do I audit engine compatibility for deprecated APIs?

Audit engine compatibility for deprecated APIs by verifying version consistency across architecture decisions and checking for post-cutoff API assumptions, ensuring the project aligns with the chosen engine's technical standards.

Can I use architecture review to pass a technical quality gate?

Yes, you can use architecture review to pass a technical quality gate by executing a full review that outputs a PASS, CONCERNS, or FAIL verdict with actionable recommendations for ADR creation and GDD revisions.

What are the limitations of mapping GDD requirements to ADRs?

Mapping GDD requirements to ADRs requires complete design documents and established engine references; without structured pre-production inputs, the traceability matrix cannot accurately detect coverage gaps or cross-ADR conflicts.