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.