architecture-advisor

Generate Architecture Decision Records in MADR format and analyze trade-offs.

3|3|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/jaskaranhundal/usap-skills --skill architecture-advisor-jaskaranhundal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-advisor
Source: https://github.com/jaskaranhundal/usap-skills/tree/main/engineering/architecture-advisor
Command: npx skills add https://github.com/jaskaranhundal/usap-skills --skill architecture-advisor-jaskaranhundal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides structured advisory for making critical architectural decisions, ensuring they are well-documented, analyzed for trade-offs, and aligned with scalability and operational requirements.

Core Features & Use Cases

  • ADR Generation: Creates Architecture Decision Records in MADR format.
  • Trade-off Analysis: Evaluates design options across key dimensions like performance, security, and cost.
  • Scalability Review: Assesses system designs for future growth.
  • Use Case: When deciding between a monolithic and microservices architecture, this Skill can analyze the trade-offs and help generate an ADR documenting the chosen path.

Quick Start

Run the architecture advisor tool to get a JSON output detailing trade-off dimensions.

Frequently Asked Questions about architecture-advisor

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

FAQPage Schema
How do I generate an Architecture Decision Record for system design trade-offs?

To generate an Architecture Decision Record, this Skill evaluates system design trade-offs across dimensions like performance, security, and cost, producing structured MADR format documentation. It outputs documented recommendations detailing the chosen architectural path.

What is the best way to document architectural decisions for scalability?

Documenting architectural decisions for scalability requires assessing system designs for future growth and analyzing operational concerns. This Skill performs scalability reviews and generates structured ADRs to ensure decisions are aligned with long-term requirements.

Can I analyze trade-offs between monolithic and microservices architecture here?

You can analyze trade-offs between monolithic and microservices architecture by evaluating design options across defined dimensions. The Skill reviews your designs and produces a JSON output detailing the trade-off dimensions for your chosen architectural path.

How do I evaluate architectural trade-offs across performance, security, and cost?

Evaluating architectural trade-offs across performance, security, and cost involves analyzing design options using a structured approach. This Skill advises on system design decisions by reviewing these dimensions and documenting the resulting recommendations in an ADR.

When do I need to create an Architecture Decision Record?

You need to create an Architecture Decision Record when making critical architectural decisions that require structured advisory. This ensures your system design choices are well-documented, analyzed for trade-offs, and aligned with operational requirements.

Does this architecture advisor require any dependencies to run?

This architecture advisor requires no dependencies to run. It operates independently to advise on system design decisions, utilizing internal scripts and references to generate ADRs and analyze architectural trade-offs.