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.