architecture-review

Validate architectural coverage against design documents and produce a governance-ready report.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/solace-ill/vector-flow --skill architecture-review-solace-ill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/solace-ill/vector-flow/tree/main/.claude/skills/architecture-review
Command: npx skills add https://github.com/solace-ill/vector-flow --skill architecture-review-solace-ill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that the complete set of architectural decisions covers all design requirements, ensures internal consistency, and aligns with the project's pinned engine version.

Core Features & Use Cases

  • Builds a Requirements Traceability Matrix by cross-referencing GDDs, ADRs, stories, and tests.
  • Detects coverage gaps, cross-ADR conflicts, and engine-version inconsistencies to prevent late-stage failures.
  • Generates governance-grade reports with recommended ADR sequencing and risk notes.

Quick Start

Run an architecture review on the current project to verify GDD coverage, ADR consistency, and engine compatibility, and produce a formal report.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I build a requirements traceability matrix from GDDs and ADRs?

To build a requirements traceability matrix, cross-reference your Game Design Documents with Architectural Decision Records, stories, and tests. This cross-referencing validates architectural coverage against design requirements to detect gaps and ensure internal consistency.

What is the best way to detect cross-ADR conflicts and engine-version inconsistencies?

Detecting cross-ADR conflicts and engine-version inconsistencies requires applying a multi-phase analysis to your architecture. This process validates ADR alignment with your project's pinned engine version to prevent late-stage integration failures and coverage gaps.

How do I generate a governance-ready architecture review report?

Generate a governance-ready architecture review report by validating design coverage and producing formal documentation. The report includes an ADR dependency ordering, conflict detection notes, risk assessments, and a structured remediation plan for identified gaps.

Can I validate architectural coverage against design documents without external dependencies?

You can validate architectural coverage without external dependencies by running a self-contained multi-phase analysis. The process builds a traceability matrix directly from your existing GDDs and ADRs to identify coverage gaps and internal consistency issues.

When do I need an ADR dependency ordering and remediation plan?

An ADR dependency ordering and remediation plan is needed when architectural decisions lack traceability or contain conflicts. It provides governance-ready risk notes and structured steps to resolve coverage gaps and engine-version inconsistencies across your project.