architect-review

Review software system designs for scalability, maintainability, and architectural best practices.

17|1|Updated Apr 20, 2022
One-click install
npx skills add https://github.com/jvegaf/harmony --skill architect-review-jvegaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-review
Source: https://github.com/jvegaf/harmony/tree/main/.agents/skills/architect-review
Command: npx skills add https://github.com/jvegaf/harmony --skill architect-review-jvegaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the need for expert architectural review to ensure systems are scalable, maintainable, and adhere to modern design principles, preventing costly technical debt and future refactoring.

Core Features & Use Cases

  • Architectural Review: Evaluates system designs and code changes against best practices like microservices, event-driven architecture, and clean architecture.
  • Scalability & Maintainability Assessment: Identifies risks and provides recommendations for improving system performance, resilience, and ease of modification.
  • Use Case: Before a major feature rollout, use this Skill to review the proposed architecture, ensuring it aligns with long-term goals and avoids introducing architectural anti-patterns.

Quick Start

Use the architect-review skill to evaluate the proposed microservice design for proper bounded context boundaries.

Frequently Asked Questions about architect-review

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

FAQPage Schema
How do I review my microservices architecture for scalability and maintainability?

Architectural review assesses microservices designs for scalability and maintainability by evaluating bounded contexts against best practices, identifying performance risks, and recommending improvements to prevent technical debt.

When do I need an architectural design review before a major feature rollout?

You need an architectural design review before major feature rollouts to ensure proposed structures align with long-term goals, adhere to clean architecture principles, and avoid introducing costly architectural anti-patterns.

What is the best way to evaluate bounded context boundaries in distributed systems?

Evaluating bounded context boundaries involves analyzing distributed system designs to ensure proper domain separation, assessing event-driven architecture patterns, and verifying alignment with cloud-native technologies and design best practices.

Can I use this approach to assess event-driven architecture for security and resilience?

Yes, architectural review assesses event-driven architecture by examining system designs for security vulnerabilities, resilience against failures, and adherence to modern design principles to ensure robust distributed systems.

Does architectural review work with cloud-native technologies and clean architecture patterns?

Architectural review works with cloud-native technologies by requiring deep understanding of distributed systems to evaluate designs against clean architecture patterns, ensuring maintainability and scalability across modern software systems.

What are the limitations of relying on design reviews for system refactoring decisions?

Design reviews focus on evaluating patterns and identifying risks rather than executing refactoring, meaning you must implement recommended architectural changes manually to resolve technical debt and improve maintainability.