architecture-reviewer

Score system architectures across seven weighted dimensions with evidence-based findings.

310|45|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/Mathews-Tom/praxis-skills --skill architecture-reviewer-mathews-tom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-reviewer
Source: https://github.com/Mathews-Tom/praxis-skills/tree/main/skills/architecture-reviewer
Command: npx skills add https://github.com/Mathews-Tom/praxis-skills --skill architecture-reviewer-mathews-tom

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides a repeatable, evidence-based workflow for evaluating system architectures across seven dimensions so teams can identify real risks, prioritize remediation, and produce an audit-quality report. It replaces ad-hoc feedback with a structured scoring system and actionable recommendations tied to concrete evidence.

Core Features & Use Cases

  • Dimension-by-dimension analysis: Evaluates Structural Integrity, Scalability, Enterprise Readiness, Performance, Security, Operational Excellence, and Data Architecture with reference-driven rubrics.
  • Modes for input types: Supports Codebase reviews (runs a scan), Document reviews (risk and completeness analysis), and Hybrid reviews (drift detection between docs and implementation).
  • Scored, template-compliant reporting: Produces 1–5 scores with weighted aggregation, severity-labeled findings, and prioritized Quick Wins / Medium-Term / Strategic recommendations using the included report template.
  • Use case: Run a pre-release technical due-diligence review of a repository or critique a migration design doc to surface security, compliance, and scaling risks with file-level evidence.

Quick Start

Review the architecture of the provided repository or design documents and produce a scored, prioritized architecture report.

Frequently Asked Questions about architecture-reviewer

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

FAQPage Schema
How do I perform a systematic architecture review of my codebase?

To perform a systematic architecture review, evaluate the codebase across seven weighted dimensions including structural integrity, scalability, and security. This process uses evidence-based findings that cite specific files to produce a scored, prioritized report.

What is the best way to conduct technical due diligence before a software release?

Conducting technical due diligence for a pre-release audit requires a scored evaluation across enterprise readiness, performance, and operational excellence. This approach identifies real risks and generates prioritized recommendations using a template-compliant report.

Can I use design documents for an architecture review instead of scanning source code?

Yes, you can evaluate design documents through a document review mode that performs risk and completeness analysis. A hybrid mode also supports drift detection between your documentation and the actual implementation.

How does scoring work in a framework-driven architecture audit?

Architecture audit scoring applies a 1-5 scale across seven weighted dimensions like data architecture and security. These individual scores undergo weighted aggregation to produce a final severity-labeled assessment with prioritized remediation steps.

Does an enterprise readiness assessment require evidence from specific repository files?

Yes, an enterprise readiness assessment requires evidence-based findings that explicitly cite repository files or document sections. This ensures the audit-quality report contains actionable recommendations grounded in your actual codebase.

What dimensions are evaluated during a security and scalability design review?

A security and scalability design review evaluates seven specific dimensions: Structural Integrity, Scalability, Enterprise Readiness, Performance, Security, Operational Excellence, and Data Architecture using reference-driven rubrics.