architecture

Guide architectural decision-making through context discovery, trade-off analysis, and ADR documentation.

1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/R2W1cs/Mustacademy --skill architecture-r2w1cs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/R2W1cs/Mustacademy/tree/main/a/.agent/skills/architecture
Command: npx skills add https://github.com/R2W1cs/Mustacademy --skill architecture-r2w1cs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill empowers you to make informed architectural decisions and understand system design complexities with a focus on requirements analysis, trade-off evaluation, and ADR documentation.

Core Features & Use Cases

  • Decision-Making Framework: Provides a structured approach to making architectural decisions, with guidance on trade-offs and patterns.
  • Context Discovery: Helps identify critical aspects of the project such as scale, team composition, timeline, domain, and constraints.
  • Trade-Off Analysis: Guides through the documentation of decisions, capturing rationale and consequences.
  • Pattern Selection: Offers a decision tree for choosing architectural patterns and a reference guide for common patterns.
  • Validation Checklist: Ensures all important considerations are met before finalizing an architecture.
  • Real-World Examples: Includes templates for various project types, demonstrating architecture decisions and their trade-offs.

Quick Start

Start designing your architecture by reviewing the 'context-discovery.md' to gather necessary project context.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architectural decisions and their trade-offs?

To document architectural decisions, you capture the decision rationale, trade-off evaluation, and consequences using a structured framework. This skill guides you through context discovery and provides templates for architecture decision records.

What is the best way to choose architectural patterns for my system design?

Choosing architectural patterns requires analyzing project requirements like scale, domain, and constraints. This skill offers a decision tree to guide pattern selection and a reference guide for evaluating common architectural patterns.

How do I start gathering project context for system design and trade-off analysis?

Start gathering project context by reviewing critical aspects like scale, team composition, timeline, and domain constraints. The skill's context discovery process ensures you collect necessary inputs for accurate trade-off analysis.

Can I use this architectural decision framework for various project types?

Yes, you can use this architectural decision framework for various project types. It includes real-world examples and templates that demonstrate architecture decisions and trade-offs across different project contexts.

How do I validate my architecture decisions before finalizing the system design?

You validate architecture decisions by running them through a validation checklist. This ensures all important considerations regarding requirements analysis and trade-offs are met before you finalize the system design.