architecture-evaluation

Evaluate software architectures by scoring quality attribute trade-offs and outputting an ADR.

7|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/AndurilCode/craftwork --skill architecture-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-evaluation
Source: https://github.com/AndurilCode/craftwork/tree/main/skills/architecture-evaluation
Command: npx skills add https://github.com/AndurilCode/craftwork --skill architecture-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture evaluation prevents teams from making system design decisions based on preference alone by structuring trade-off analysis, documenting reasoning, and reducing the risk of irreversible mistakes.

Core Features & Use Cases

  • Structured decision context: Clarifies the exact decision, drivers, constraints, and stakeholders before evaluating options.
  • Quality-attribute trade-off scoring: Rates scalability, reliability, performance, security, maintainability, operability, and cost to compare alternatives consistently.
  • ADR-ready outputs: Produces an Architecture Decision Record (ADR) including context, decision, consequences, and rejected alternatives.

Quick Start

Use the architecture-evaluation skill to evaluate whether you should choose microservices or a modular monolith for an upcoming order system design, based on scalability, reliability, operability, and cost constraints.

Frequently Asked Questions about architecture-evaluation

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

FAQPage Schema
How do I evaluate trade-offs between competing software architectures?

Evaluating architecture trade-offs requires structuring the decision context by clarifying drivers and constraints, then scoring quality attributes like scalability, reliability, and cost to consistently compare alternatives.

What is an architecture decision record and when do I need one?

An ADR documents context, decision, consequences, and rejected alternatives. You need one when system design choices trigger uncertainty, lack prior analysis, or carry irreversible lock-in risks.

How do I choose between a microservices or modular monolith architecture?

Choosing between microservices and a modular monolith requires rating scalability, reliability, operability, and cost against your stated constraints to identify the option with acceptable trade-offs.

How do I assess migration and adoption implications for a new system design?

Assess migration and adoption implications by analyzing architecture trade-offs alongside reversibility and lock-in considerations to understand the long-term consequences of committing to a system design.

When should I use structured trade-off analysis for deployment model decisions?

Use structured trade-off analysis for deployment model decisions when facing high uncertainty or lacking prior analysis, ensuring choices rely on explicit quality attributes rather than preference alone.

What quality attributes should I compare when selecting a database or messaging system?

When selecting a database or messaging system, compare quality attributes including scalability, reliability, performance, security, maintainability, operability, and cost to map trade-offs accurately.