architecture

Document architecture decisions using ADRs and structured trade-off analyses.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/TwuanMinn/fadelab --skill architecture-twuanminn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/TwuanMinn/fadelab/tree/main/.agent/skills/skills/architecture
Command: npx skills add https://github.com/TwuanMinn/fadelab --skill architecture-twuanminn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decisions often lack a structured reasoning process. This Skill provides a framework to analyze requirements, compare options, document trade-offs, and capture rationale using ADRs.

Core Features & Use Cases

  • ADR templates and decision records to capture rationale
  • Requirements analysis and trade-off evaluation for architecture decisions
  • Pattern references and example decision workflows to guide design

Quick Start

Draft an Architecture Decision Record for your current design choice, including context, options, and trade-offs.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architecture decisions using ADRs?

Architecture Decision Records document design choices by capturing context, comparing options, and recording trade-offs. This framework provides ADR templates to structure rationale and ensure architectural decisions are systematically evaluated and traceable.

What is the best way to evaluate architecture trade-offs?

Evaluating architecture trade-offs involves analyzing requirements against a library of architecture patterns. This framework structures the comparison process, guiding you to weigh options methodically and document the resulting decision records for your project.

How do I select architecture patterns for my project?

Selecting architecture patterns requires mapping project requirements to known design solutions. This framework provides pattern references and example workflows to guide pattern selection, ensuring chosen patterns align with your specific trade-off evaluations.

When do I need an Architecture Decision Record?

You need an Architecture Decision Record when a design choice involves significant trade-offs or impacts multiple components. Using ADR documentation captures the reasoning process, preventing undocumented architectural decisions and providing future context.

Can I apply this architecture decision framework to existing projects?

Yes, you can apply this framework to existing projects by drafting an Architecture Decision Record for current design choices. The structured requirements analysis and trade-off evaluation process adapts to document decisions across various project stages.

Does this framework support requirements analysis before pattern selection?

Yes, requirements analysis is a core component supported before pattern selection. The framework integrates requirements analysis with trade-off evaluation, ensuring architecture patterns are chosen based on structured project needs rather than assumptions.