architecture-review

Assess repository-defined architecture against reliability, security, cost, operational, and performance pillars.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill architecture-review-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/architecture-review
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill architecture-review-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing the architecture a repository defines is slow and inconsistent when done ad hoc, and findings often lack evidence or overlap with deployed-environment audits. This Skill produces an evidence-based, design-time architecture assessment with pillar-aligned findings, trade-offs, and explicit coverage limits. ## Core Features & Use Cases - Pillar-Aligned Assessment: Evaluates reliability, security, cost, operational excellence, and performance efficiency from infrastructure-as-code, configuration, and decision records. - Evidence-Grounded Findings: Every finding cites a concrete repository path or ADR, carries severity and confidence, and is validated against a JSON schema. - Clear Boundaries: Read-only by design, separates covered from uncovered scope, and defers deployed-tenant posture to audit-azure-environment. - Use Case: Before a first production deployment of a Bicep-defined Azure workload, run this Skill to reconstruct the architecture from the IaC, flag decision-record violations, and emit reports/architecture-review.json and .md. ## Quick Start Ask the agent to run an architecture review of this repository's infrastructure definitions and configuration, scoped to the production environment on Azure.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I review cloud architecture defined in a repository?

Run this Skill to reconstruct the architecture from infrastructure definitions and configuration rather than documentation claims. It assesses five pillars and writes schema-validated findings to reports/architecture-review.json and reports/architecture-review.md.

What is the difference between design-time architecture review and environment audit?

Design-time review assesses the architecture a repository defines from IaC and configuration before deployment. Deployed-environment posture of a live cloud tenant belongs to the audit-azure-environment skill, not this one.

Does architecture review work with Bicep and Azure workloads?

Yes, it reviews Bicep-defined Azure workloads and verifies that each recommended service exists in the target region and cloud. Recommendations that cannot be confirmed are explicitly flagged.

Can this skill modify infrastructure or decision records?

No, the skill is strictly read-only and never modifies infrastructure definitions, configuration, or ADRs. Any change to those artifacts requires separate explicit approval outside this skill.

What happens when architecture evidence is incomplete?

The skill fails closed when the architecture cannot be reconstructed from available evidence. It returns a partial review only when covered and uncovered scope are separated explicitly, and never asserts compliance without supporting evidence.