architecture

Document architectural decisions with ADR templates and trade-off analysis.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decision-making framework to capture requirements, analyze trade-offs, and document rationale in a structured, repeatable way.

Core Features & Use Cases

  • ADR templates and guidance for recording decisions
  • Trade-off analysis to compare options across quality attributes and constraints
  • Context discovery and decision traceability to ensure alignment with stakeholders
  • Use Case: Apply ADRs when selecting architectural patterns or evaluating system design choices.

Quick Start

Create an ADR for your next architectural decision, then document context, options, and rationale.

Frequently Asked Questions about architecture

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

FAQPage Schema
What is an architectural decision record and when do I need one?

An architectural decision record (ADR) captures context, options, and rationale for system design choices. You need an ADR when selecting architectural patterns or evaluating trade-offs to ensure traceable decisions and stakeholder alignment.

How do I analyze trade-offs when selecting architectural patterns?

Analyze trade-offs by comparing architectural options across quality attributes and constraints. Document the context, evaluate each pattern's impact, and record the rationale to guide pattern-selection and ensure decisions align with stakeholder requirements.

What is the best way to document architectural decisions for governance?

The best way to document architectural decisions for governance is using ADR templates to capture context, options, and rationale. This creates traceable decision records that align system design with stakeholder requirements and formalize trade-off analysis.

How do I ensure architectural decisions are traceable to stakeholders?

Ensure architectural decisions are traceable to stakeholders by using context discovery and formal decision records. Documenting the rationale and trade-offs in ADRs maintains alignment and provides a clear history of why specific architectural choices were made.

Can I apply architectural decision-making to any software engineering project?

Yes, you can apply architectural decision-making to any project requiring system design choices. The framework is applicable across software architecture tasks to document context, compare options, and record trade-off rationale in a structured, repeatable way.

When should I not use formal architectural decision records?

You should not use formal architectural decision records for minor implementation details that lack significant trade-offs. ADRs are designed for capturing context and rationale when selecting architectural patterns or evaluating major system design choices.