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.