architecture-review

Review software architectures against quality attributes using the CACR loop.

2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/michaelalber/ai-toolkit --skill architecture-review-michaelalber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/michaelalber/ai-toolkit/tree/main/skills/architecture-review
Command: npx skills add https://github.com/michaelalber/ai-toolkit --skill architecture-review-michaelalber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill acts as a devil's advocate to identify potential flaws, hidden assumptions, and vulnerabilities in your software architecture before they become costly problems during development or in production.

Core Features & Use Cases

  • Socratic Questioning: Challenges designs against principles like SOLID, coupling, failure modes, scalability, and operational complexity.
  • Structured Review Process: Guides users through a CACR (Challenge, Attempt, Compare, Reflect) loop to build architectural judgment.
  • Use Case: Before committing to a new microservices design, use this Skill to rigorously question its assumptions, identify potential coupling issues, and explore failure scenarios to ensure robustness.

Quick Start

Initiate an architecture review by providing the system's name, architect, purpose, and a description of the architecture.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I stress-test software architecture for failure modes and scalability issues?

To stress-test software architecture, you can use a structured Socratic review process to challenge assumptions, coupling, and failure modes against critical quality attributes. This generates vulnerability reports and facilitates tradeoff acceptance for robust system designs.

What is a Socratic architecture review and how does it evaluate system robustness?

A Socratic architecture review evaluates system robustness by rigorously questioning designs against principles like SOLID, coupling, failure modes, scalability, and operational complexity. It challenges hidden assumptions to identify potential flaws before production.

How do I identify hidden coupling and vulnerabilities in a microservices design?

You can identify hidden coupling and vulnerabilities in a microservices design by applying a structured review loop that challenges assumptions and explores failure scenarios. This process ensures robustness by facilitating tradeoff acceptance for resilient systems.

Can I use an architecture design review to assess operational complexity before committing to development?

Yes, you can use an architecture design review to assess operational complexity before committing to development. It acts as a devil's advocate to identify potential flaws and vulnerabilities in your software architecture before they become costly production problems.

What information do I need to provide to start an architecture risk assessment?

To start an architecture risk assessment, you need to provide the system's name, architect, purpose, and a description of the architecture. This initiates the structured review process to evaluate quality attributes and generate vulnerability reports.

When should I not use a Socratic design review for software architecture?

You should avoid using a Socratic design review when you lack a defined architecture description or system purpose, as the structured review process requires these inputs to challenge assumptions and evaluate quality attributes effectively.