architecture-review

Review architecture documents for risks and prioritized recommendations.

2|2|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill architecture-review-adolfoaranaes12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/architecture-review
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill architecture-review-adolfoaranaes12

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires architecture-review-template, and includes references (resource) and templates (resource) components.

What problem does it solve?

This Skill performs a peer review of architecture documents, identifies risks, and produces prioritized recommendations and alternatives considered.

Core Features & Use Cases

  • Load architecture and context
  • Evaluate scalability, security, performance, and tech fit
  • Provide actionable recommendations with risk-based prioritization
  • Compare alternatives considered

Quick Start

Review an architecture document and return a synthesis report.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I perform an architecture peer review to identify risks and quality gaps?

An architecture peer review systematically evaluates design documents for scalability, security, performance, maintainability, and technology fit. This Skill analyzes your architecture, identifies risks with severity levels, and delivers prioritized recommendations with alternatives considered to improve overall quality and reduce implementation risk.

What should I include in an architecture document before submitting it for review?

Provide complete architectural context including system design, technology choices, scalability approach, security considerations, and performance strategy. The review process evaluates these dimensions against your project constraints, so detailed documentation enables thorough risk identification and actionable optimization recommendations.

How are recommendations prioritized in an architecture review?

Recommendations are prioritized by risk severity and impact. The review identifies critical risks first, then sequences recommendations based on their effect on scalability, security, and maintainability, helping you address the most consequential issues before lower-impact optimizations.

Can an architecture review help validate technology choices before implementation?

Yes. The review evaluates technology fit alongside scalability, performance, and cost considerations. This validation identifies potential mismatches early, compares alternatives considered, and confirms your technology stack aligns with project requirements before committing to implementation.

What types of architectural decisions can be reviewed with this process?

This process reviews any major architectural decision—infrastructure design, microservices vs. monolith choices, data storage strategy, API design, deployment architecture, and technology selections. It surfaces hidden risks, suggests optimization opportunities, and documents alternatives to strengthen decision validity.