skills.rest
matt-metivier
matt-metivierCOMMUNITY
Explore all skills by this author →
GitHub

architecture-reviewer

Assess distributed system architecture designs for boundaries, data flow, and failure modes.

Updated Aug 23, 2026
Search Tags:#architecture#review#distributed-systems#data-flow#design-review#operability#service-boundaries
One-click install
npx skills add https://github.com/matt-metivier/zk-hub --skill architecture-reviewer-matt-metivier
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-reviewer
Source: https://github.com/matt-metivier/zk-hub/tree/main/skills/general/domain/architecture-reviewer
Command: npx skills add https://github.com/matt-metivier/zk-hub --skill architecture-reviewer-matt-metivier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions in distributed systems are prone to misalignment and hidden risks. This guide provides a structured approach to evaluate boundaries, data flow, failure modes, scalability, and operability to drive safer, more maintainable designs.

Core Features & Use Cases

  • Evaluate service boundaries to ensure clear ownership and minimal public contracts.
  • Analyze data flow and failure modes to identify bottlenecks, consistency requirements, and recovery options.
  • Improve operability and scalability by guiding observability, deployment strategies, and horizontal scaling.

Quick Start

Provide a structured architecture review for a new service proposal or major refactor.

Frequently Asked Questions about architecture-reviewer

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

FAQPage Schema
How do I review architecture designs for distributed systems?▼

To review distributed systems architecture, assess design docs or RFCs against criteria for service boundaries, data flow, failure modes, scalability, and operability to ensure robust and maintainable designs.

What is a design review for service boundaries and data flow?▼

A service boundaries and data flow design review evaluates ownership clarity and public contracts, identifying bottlenecks and consistency requirements to minimize misalignment and hidden risks in distributed architectures.

Can I use a structured architecture review for a system refactor proposal?▼

Yes, you can apply a structured architecture review to new service proposals or major refactors to evaluate failure resilience, observability, deployment strategies, and horizontal scaling capabilities.

What's the best way to analyze failure modes in distributed architecture diagrams?▼

The best way to analyze failure modes in architecture diagrams is to apply evaluation criteria for failure resilience and data flow, identifying bottlenecks, consistency requirements, and recovery options.

Does architecture review help with operability and scalability guidance?▼

Architecture review improves operability and scalability by guiding observability, deployment strategies, and horizontal scaling to drive safer, more maintainable distributed system designs.

When should I not use a structured architecture review guide?▼

A structured architecture review guide targets distributed systems with complex service boundaries and failure modes; it is not suited for simple monolithic applications lacking distinct data flow or scalability concerns.

Related Skills

Explore More Software Engineering Skills→
vadimcomanescuvadimcomanescu
24

senior-architect

Generate Mermaid diagrams and ADR templates from project dependency analysis.

Community
Advanced
mislam-devmislam-dev
1

microservices-architecture

Design microservices architectures with service boundaries and communication patterns.

Community
Advanced
cornmanwtfcornmanwtf

monolith-to-microservices-migrator

Plan monolithic to microservices migration with service boundaries and strangler strategies.

Community
Advanced
ArabelaTsoArabelaTso
142

component-boundary-identifier

Analyze Python codebases to identify component boundaries and detect architectural violations.

Community
Intermediate