architecture-review

Review software design documents and cross-repo contracts for risks.

3|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/KeyValueSoftwareSystems/maestro --skill architecture-review-keyvaluesoftwaresystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/KeyValueSoftwareSystems/maestro/tree/main/skills/core/sdlc/architecture-review
Command: npx skills add https://github.com/KeyValueSoftwareSystems/maestro --skill architecture-review-keyvaluesoftwaresystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the risk of architectural drift and design flaws by providing a standardized, rigorous, and repeatable review process for software designs before implementation begins.

Core Features & Use Cases

  • Standardized Checklist: Evaluates designs across critical dimensions including security, scalability, data modeling, and contract soundness.
  • Evidence-Based Reporting: Forces the AI to cite specific design elements or gaps, ensuring accountability and clarity in feedback.
  • Use Case: A lead engineer uses this skill to perform a final check on a new microservice design, ensuring that all cross-service contracts and data migration plans are robust and compliant with team standards.

Quick Start

Run the architecture-review skill to analyze the design documents in the current directory and generate a formal review report.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
What is an automated architecture review for software design?

An automated architecture review is a read-only assessment of software design documents that evaluates technical designs against predefined criteria for security, scalability, data integrity, and system reliability to generate an evidence-backed risk report.

How do I review cross-repo contracts before microservice implementation?

You can review cross-repo contracts by running an automated architecture assessment against the design documents in your directory. The review evaluates contract soundness and data modeling to ensure cross-service interactions are robust and compliant with team standards.

Does automated architecture review check for security and compliance in the SDLC?

Yes, automated architecture review checks for security and compliance by evaluating designs against a standardized checklist across the SDLC. It forces evidence-based reporting by citing specific design gaps to ensure accountability in the feedback.

How do I prevent architectural drift in software designs?

You prevent architectural drift by applying a standardized, rigorous, and repeatable review process to software designs before implementation begins. This process evaluates cross-repo contracts and data migration plans to identify blocking issues early.

Can I assess data migration plans and system reliability without modifying code?

Yes, you can assess data migration plans and system reliability without modifying code because the architecture review performs a comprehensive, read-only architectural assessment. It strictly evaluates technical designs and generates a formal report without altering your codebase.

What are the limitations of using AI for architectural assessment?

The primary limitation of using AI for architectural assessment is that it relies entirely on the provided design documents and predefined criteria. It operates as a read-only analysis, meaning it cannot detect undocumented risks or evaluate runtime behavior outside the specified technical designs.