architecture-review

Validate project architecture against GDDs and ADRs with a verdict.

Updated May 16, 2026
One-click install
npx skills add https://github.com/SeongHuni/LightNShadowSurviver --skill architecture-review-seonghuni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/SeongHuni/LightNShadowSurviver/tree/main/GameStudio/codex/skills/architecture-review
Command: npx skills add https://github.com/SeongHuni/LightNShadowSurviver --skill architecture-review-seonghuni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of project architecture against all GDDs, providing a comprehensive review report that identifies gaps, conflicts, and ensures engine compatibility.

Core Features & Use Cases

  • Comprehensive Review: Validates completeness and consistency of project architecture against all GDDs.
  • Traceability Matrix: Builds a matrix mapping every GDD technical requirement to ADRs, identifying coverage gaps and conflicts.
  • Engine Compatibility: Verifies engine compatibility consistency across all decisions.
  • Review Report: Produces a PASS/CONCERNS/FAIL verdict with detailed findings and recommendations.

Quick Start

Run the architecture-review skill with the 'full' argument to perform a full review of the project architecture.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I automate project architecture validation against GDDs and ADRs?

Automate project architecture validation by running a full review that checks GDDs and ADRs for coverage gaps, cross-ADR conflicts, and engine compatibility, generating a comprehensive report with a PASS, CONCERNS, or FAIL verdict.

What is an architecture traceability matrix and how does it find coverage gaps?

An architecture traceability matrix maps every technical requirement from your GDDs to corresponding ADRs. It detects coverage gaps by identifying requirements lacking matching architectural decisions, ensuring complete project validation.

Can I check engine compatibility consistency across all architectural decisions?

Yes, engine compatibility is verified by checking consistency across all ADRs. The review process confirms that every architectural decision aligns with the target engine requirements, preventing technical conflicts.

How do I generate a comprehensive architecture review report with a verdict?

Generate a comprehensive architecture review report by running the full review process. It produces detailed findings, recommendations, and a final PASS, CONCERNS, or FAIL verdict based on GDD and ADR analysis.

What do I need to perform a full architecture review of my project?

To perform a full architecture review, you need your project's GDDs and ADRs available. The review extracts technical requirements, builds a traceability matrix, detects conflicts, and checks engine compatibility automatically.