architecture-decision

Document architecture decisions with structured templates for context, consequences, and trade-offs.

161|21|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/softspark/ai-toolkit --skill architecture-decision-softspark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/softspark/ai-toolkit/tree/main/app/skills/architecture-decision
Command: npx skills add https://github.com/softspark/ai-toolkit --skill architecture-decision-softspark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often made without preserving context or rationale. This Skill provides a structured method to capture decisions, trade-offs, and consequences in a reusable architecture-note format.

Core Features & Use Cases

  • Structured architecture notes: capture context, options, decisions, and consequences.
  • Trade-off matrix templates: compare options across key factors like reliability, cost, and maintainability.
  • Reusable ADR-style templates: quick-start notes for migrations, tech selection, and design reviews.

Quick Start

Create an Architecture Decision Note for a design problem and include context, candidate options, recommended choice, and consequences.

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I document architecture decisions to preserve context across projects?

Document architecture decisions using structured templates that capture context, options, choices, and consequences. This preserves rationale and context for future reference across projects.

What is the best way to create an ADR for a technology evaluation?

Create an ADR for technology evaluation by applying reusable templates to capture context, candidate options, recommended choices, and consequences. This ensures structured documentation of trade-offs and directions.

How do I compare architecture options across factors like reliability and cost?

Compare architecture options using a trade-off matrix template to evaluate factors like reliability, cost, and maintainability. This provides structured comparison across key decision criteria.

Can I use architecture notes for design reviews and migrations?

Architecture notes apply to design reviews, migrations, and technology evaluations. They capture trade-offs and recommended directions in a reusable format for structured documentation.

What should I include in an architecture decision record for a design problem?

Include context, candidate options, recommended choice, and consequences in an architecture decision note. This structured approach captures the full rationale and expected outcomes of the decision.

Why do I need to document trade-offs and consequences in architecture decisions?

Documenting trade-offs and consequences in architecture decisions preserves rationale and context that is often lost. This prevents repeated discussions and maintains clarity across project timelines.