architecture-review

Evaluate software architecture across six dimensions and produce trade-off analyses.

5|2|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/ZacharyLuz/github-copilot-chat-exporter --skill architecture-review-zacharyluz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/ZacharyLuz/github-copilot-chat-exporter/tree/main/.claude/skills/engineering/architecture-review
Command: npx skills add https://github.com/ZacharyLuz/github-copilot-chat-exporter --skill architecture-review-zacharyluz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach for evaluating software architecture across scalability, maintainability, security, performance, and cost to guide design decisions and reduce architectural risk.

Core Features & Use Cases

  • Structured, multi-dimensional evaluation across six architecture dimensions.
  • Trade-off analysis and actionable recommendations for architecture decisions, debt assessment, and refactoring planning.
  • Documentation guidance suitable for ADRs and governance artifacts.

Quick Start

Perform an architecture review for a new microservice focusing on scalability, maintainability, and security.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
What is a software architecture review and what dimensions should it evaluate?

An architecture review for microservices evaluates system design across scalability, maintainability, and security dimensions. It applies to systems from monoliths to microservices, producing structured checklists and trade-off analyses tailored to distributed architectures.

How do I perform an architecture review for a new microservice?

To perform an architecture review for a new microservice, evaluate its scalability, maintainability, and security dimensions. This generates a structured checklist, trade-off analyses, and actionable recommendations to inform design decisions and feed architectural documentation.

Can this architecture review process be used for technical debt assessment?

Yes, the architecture review process supports technical debt assessment and refactoring planning. It evaluates reliability and cost alongside maintainability to produce trade-off analyses and actionable recommendations for governance artifacts.

What's the best way to document architecture trade-offs and design decisions?

The best way to document architecture trade-offs is through structured evaluation across scalability, security, and cost dimensions. This produces actionable recommendations and trade-off analyses suitable for feeding Architecture Decision Records (ADRs) and governance artifacts.

Does a structured architecture review work for both monoliths and microservices?

Yes, a structured architecture review works for both monoliths and microservices. It applies a six-dimensional evaluation covering scalability, maintainability, security, performance, reliability, and cost to inform design decisions across diverse system architectures.