Architecture Review

Review architectural designs against patterns and generate Architecture Decision Records.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/StrategicMilk/Vetinari-Orchestrastor --skill architecture-review-strategicmilk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Review
Source: https://github.com/StrategicMilk/Vetinari-Orchestrastor/tree/main/vetinari/skills/catalog/worker/architecture-review
Command: npx skills add https://github.com/StrategicMilk/Vetinari-Orchestrastor --skill architecture-review-strategicmilk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a systematic, read‑only analysis of architectural proposals, ensuring they adhere to Vetinari’s patterns, conventions, and quality attributes while automatically drafting Architecture Decision Records.

Core Features & Use Cases

  • Pattern compliance: Checks designs against known architectural patterns and Vetinari’s coding conventions.
  • Quality assessment: Evaluates maintainability, testability, extensibility, performance, and security.
  • ADR generation: Produces detailed Architecture Decision Records for approved designs and documents alternatives and trade‑offs.
  • Risk identification: Flags coupling issues, security boundaries, and other architectural risks.

Quick Start

Ask the worker to review the proposed microservice architecture and generate an ADR summarizing the findings.

Frequently Asked Questions about Architecture Review

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

FAQPage Schema
How do I generate an Architecture Decision Record for a new feature design?

To generate an Architecture Decision Record, provide the task description, design details, and relevant files. The review evaluates pattern compliance and quality attributes, producing an ADR draft with alternatives, trade-offs, and required changes.

What is architecture design review for pattern compliance and risk identification?

Architecture design review is a systematic, read-only analysis that validates proposals against established patterns and coding conventions. It identifies coupling issues, security boundaries, and other architectural risks while assessing maintainability, testability, extensibility, performance, and security.

Can I use design review to evaluate microservice architecture for codebase extensions?

Yes, design review applies to evaluating microservice architecture and codebase extensions. It checks proposed designs against known architectural patterns and Vetinari's conventions, returning a compliance verdict, required changes, and drafted ADRs for approved designs.

What's the best way to document architectural trade-offs and alternatives for approved designs?

The best way to document architectural trade-offs is through automated ADR generation during the design review process. It produces detailed Architecture Decision Records that explicitly document alternatives and trade-offs alongside the compliance verdict for approved designs.

Do I need to provide quality attributes as input for an architecture quality assessment?

Quality attributes are optional input parameters for the architecture quality assessment. Providing them allows the review to specifically evaluate maintainability, testability, extensibility, performance, and security against your desired targets, but the review can proceed without them.