architecture

Analyze requirements, evaluate trade-offs, and document architectural decisions in ADRs.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/danilomartinelli/cursor-kit --skill architecture-danilomartinelli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/danilomartinelli/cursor-kit/tree/main/skills/architecture
Command: npx skills add https://github.com/danilomartinelli/cursor-kit --skill architecture-danilomartinelli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for making sound architectural decisions, analyzing trade-offs, and documenting the rationale behind them using Architecture Decision Records (ADRs).

Core Features & Use Cases

  • Requirements Analysis: Guides through asking critical questions about scale, team, timeline, domain, and constraints.
  • Trade-off Evaluation: Provides templates and frameworks for comparing different architectural options.
  • ADR Documentation: Facilitates the creation of clear, concise ADRs to capture decisions and their justifications.
  • Use Case: When deciding between a monolithic architecture and microservices for a new application, use this Skill to systematically evaluate the pros and cons, document the decision, and outline the accepted trade-offs.

Quick Start

Use the architecture skill to document a decision about choosing a database for a new project.

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 evaluate trade-offs?

To document architectural decisions, you can use a framework for trade-off evaluation and Architecture Decision Record (ADR) documentation. This provides templates to compare options and capture the rationale behind your choices.

What is the best way to choose between a monolithic architecture and microservices?

The best way to choose between a monolithic architecture and microservices is to systematically evaluate the pros and cons. You can compare options based on project context, scale, timeline, and accepted trade-offs.

How do I analyze requirements for system design?

Requirements analysis for system design involves asking critical questions about scale, team, timeline, domain, and constraints. This guides the evaluation of architectural options based on your specific project context.

When should I write an Architecture Decision Record for my project?

You should write an Architecture Decision Record when you need to capture architectural decisions and their justifications. It facilitates clear documentation of the selected patterns and the trade-offs accepted for your project context.

Can I use this framework to select appropriate architectural patterns for my application?

Yes, you can use this framework to select appropriate architectural patterns. It supports systematic evaluation of options and facilitates the selection process based on your specific constraints and requirements.

Does evaluating trade-offs require understanding project constraints?

Yes, evaluating trade-offs requires understanding project constraints. The framework guides you through critical questions about scale, team, timeline, and domain to systematically compare architectural options and document accepted trade-offs.