architecture

Guides requirements analysis, trade-off evaluation, and ADR documentation for architectural decisions.

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

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, ensuring that requirements are met, trade-offs are evaluated, and decisions are well-documented.

Core Features & Use Cases

  • Requirements Analysis: Guides the process of understanding project needs and constraints.
  • Trade-off Evaluation: Provides tools and templates for analyzing the pros and cons of different architectural options.
  • ADR Documentation: Facilitates the creation of Architecture Decision Records to capture rationale and history.
  • Use Case: When starting a new project, use this Skill to systematically explore architectural patterns, document the chosen approach, and ensure alignment with project goals.

Quick Start

Use the architecture skill to analyze trade-offs for a new microservices project.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I evaluate architectural trade-offs for a new software project?

To evaluate architectural trade-offs, use a structured framework to analyze project requirements and constraints, comparing the pros and cons of different system design options. This ensures selected patterns align with your specific scale and timeline.

What is an Architecture Decision Record and how does it help system design?

An Architecture Decision Record (ADR) is a document that captures the rationale and history behind system design choices. It provides a structured template to record trade-off evaluations, ensuring architectural decisions are well-documented for future reference.

How do I choose the right architectural patterns based on project scale and team expertise?

Choosing the right architectural patterns requires systematic selection using decision trees that weigh project scale, team expertise, and timeline constraints. This framework guides you through requirements analysis to match patterns with your project goals.

Can I use this framework to document architectural decisions for microservices?

Yes, you can use this framework to document architectural decisions for microservices by applying the provided ADR templates. It facilitates systematic exploration of microservices trade-offs and captures the chosen approach for your project.

When should I start documenting architectural decisions during system design?

You should start documenting architectural decisions during system design as soon as you begin evaluating trade-offs and selecting patterns. Creating Architecture Decision Records early captures the initial rationale and ensures alignment with project goals.

What is the best way to structure an architectural decision-making process?

The best way to structure an architectural decision-making process is by following a systematic framework that moves from requirements analysis to trade-off evaluation, culminating in ADR documentation using decision trees and structured templates.