Architecture Decision

Assess project complexity and recommend architecture patterns with documented trade-offs.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/michsindlinger/specwright --skill architecture-decision-michsindlinger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Decision
Source: https://github.com/michsindlinger/specwright/tree/main/specwright/templates/skills/architecture-decision
Command: npx skills add https://github.com/michsindlinger/specwright --skill architecture-decision-michsindlinger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured process for making informed architecture decisions, ensuring that the chosen patterns align with project complexity and documenting the rationale and trade-offs.

Core Features & Use Cases

  • Complexity Assessment: Guides users through scoring project complexity across five dimensions.
  • Pattern Recommendation: Offers a framework for matching complexity scores to appropriate architecture patterns (e.g., Layered, Clean Architecture, Microservices).
  • Trade-off Documentation: Provides a template for documenting the pros, cons, and alternatives of a chosen architecture.
  • Use Case: When starting a new project, use this skill to systematically evaluate architectural choices, ensuring the team selects a scalable and maintainable solution from the outset.

Quick Start

Use the architecture decision skill to assess complexity and recommend a pattern for a new e-commerce platform.

Frequently Asked Questions about Architecture Decision

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

FAQPage Schema
How do I document software architecture decisions and trade-offs?

Document software architecture decisions by recording the rationale, trade-offs, and alternatives evaluated. This approach uses a structured template to capture the pros and cons of the chosen design patterns, ensuring the team understands the context behind the selected architecture.

What is the best way to assess project complexity for architecture design?

Assess project complexity for architecture design by scoring the project across five distinct dimensions. This structured evaluation helps determine the appropriate software design patterns needed to handle the system's specific complexity.

How do I choose between layered, clean architecture, and microservices?

Choose between layered, clean architecture, and microservices by matching your project's complexity scores to a pattern recommendation framework. This ensures the selected architecture aligns with the specific scalability and maintainability needs of your software.

When should I evaluate architectural choices and design patterns for a new project?

Evaluate architectural choices and design patterns at the outset of a new project to ensure a scalable and maintainable solution. Assessing complexity early prevents misaligned software design and documents the rationale before development begins.

Does this architecture decision process work for any software design pattern?

Yes, the architecture decision process works across various software design patterns by mapping complexity assessment scores to appropriate recommendations. It guides the selection of suitable patterns like Layered, Clean Architecture, or Microservices based on specific project needs.

Why do I need to document alternatives when making architecture decisions?

Documenting alternatives when making architecture decisions provides a clear record of why other design patterns were rejected. Capturing these trade-offs ensures future teams understand the constraints and rationale behind the chosen software design.