architecture-review

Plan and validate system architecture decisions against requirements and best practices.

Updated May 7, 2025
One-click install
npx skills add https://github.com/enchantednatures/.dotfiles --skill architecture-review-enchantednatures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/enchantednatures/.dotfiles/tree/main/.config/opencode/skills/architecture-review
Command: npx skills add https://github.com/enchantednatures/.dotfiles --skill architecture-review-enchantednatures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture review helps teams systematically evaluate and validate system architecture decisions to ensure they align with requirements, design principles, and long-term maintainability.

Core Features & Use Cases

  • Structured evaluation of architecture decisions against functional and non-functional requirements.
  • Pattern and design-choices assessment, risk identification, and guidance for improvements.
  • Documentation artifacts like an Architecture Review Report to communicate findings to stakeholders and guide next steps.

Quick Start

Review the current architecture against requirements using the Architecture Review process and generate an Architecture Review Report.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I validate system architecture decisions against requirements?

To validate architecture, evaluate pattern suitability, requirement alignment, component design, data flow, integration points, scalability, and security considerations to ensure they align with functional and non-functional requirements.

What is the best way to assess pattern suitability and risk during a major feature addition?

Assess pattern suitability and risk by performing a structured architecture review that evaluates design choices against requirements and best practices, generating an Architecture Review Report to guide improvements.

When do I need an architecture review for refactoring or design?

You need an architecture review during design, refactoring, or major feature additions to systematically evaluate system decisions, identify risks, and ensure long-term maintainability against requirements.

Can I use an architecture review to evaluate scalability and security considerations?

Yes, an architecture review evaluates scalability and security considerations by assessing component design, data flow, and integration points to validate alignment with non-functional requirements and best practices.

What are the limitations of an architecture review for system design?

An architecture review does not implement changes; it provides a structured evaluation and an Architecture Review Report documenting findings, risk identification, and guidance for improvements to communicate to stakeholders.