architect-review

Review software system designs for risks, trade-offs, and improvements.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/y0ncha/aptitude-client --skill architect-review-y0ncha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-review
Source: https://github.com/y0ncha/aptitude-client/tree/main/.agents/skills/architect-review
Command: npx skills add https://github.com/y0ncha/aptitude-client --skill architect-review-y0ncha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architects and teams often struggle to ensure architectural integrity and alignment with standards when designing or reviewing complex software systems, leading to risk and design debt.

Core Features & Use Cases

  • Architectural decision reviews across microservices, DDD, and clean architecture to ensure consistency.
  • Risk and trade-off analysis with actionable recommendations and validation plans.
  • Documentation support (ADR-style decisions) and governance for architecture patterns and standards.

Quick Start

Provide a structured architectural review for a proposed system design, outlining goals, constraints, and key trade-offs.

Frequently Asked Questions about architect-review

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

FAQPage Schema
How do I review a microservices architecture for design consistency and risks?

To review a microservices architecture, apply governance checks across domain-driven design and clean architecture contexts to assess risks, recommend improvements with trade-offs, and document validation plans. This ensures architectural integrity and alignment with standards.

What is the best way to document architectural decisions for system designs?

The best way to document architectural decisions is using ADR-style formats that capture goals, constraints, and trade-offs. This provides governance for architecture patterns and ensures alignment across microservices and event-driven systems.

How do I assess trade-offs in an event-driven architecture proposal?

Assess trade-offs in an event-driven architecture by gathering context, identifying risks, and providing actionable recommendations with validation documentation. This approach ensures resilience and consistency across domain-driven design boundaries.

Can I use this approach to review code changes against clean architecture standards?

Yes, you can review code changes against clean architecture standards by applying architectural governance to ensure consistency. The process includes context gathering, risk assessment, and recommended improvements to prevent design debt.

When do I need an architectural review for domain-driven design contexts?

You need an architectural review for domain-driven design contexts when ensuring architectural integrity across complex microservices. It helps identify design debt, assess risks, and validate that system designs satisfy scalability and resilience requirements.