architecture

Name: architecture
Availability: InStock
Author: barbosakjn

Guide architectural decisions using a structured ADR framework.

1|Updated Dec 28, 2025

Search Tags:#architecture #documentation #adr #patterns #trade-off #decision-record

Ready to run

npx skills add https://github.com/barbosakjn/finance-app --skill architecture-barbosakjn

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/barbosakjn/finance-app/tree/main/.agent/workflows/.agent/skills/architecture
Command: npx skills add https://github.com/barbosakjn/finance-app --skill architecture-barbosakjn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decision-making is often ad-hoc, leading to inconsistent designs and brittle ADRs.

Core Features & Use Cases

ADR templates and documentation scaffolding to capture rationale.
Trade-off analysis guidance to compare options and record decisions.
Context discovery guidance and pattern references to inform design choices.

Quick Start

Open the ADR templates and start a new architecture decision record for your current 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 for system design?▼

To document architectural decisions for system design, use a structured ADR framework to capture context, evaluate trade-offs, and record the final rationale. This guided workflow ensures your technology selection and design reviews produce consistent, durable decision records rather than ad-hoc notes.

What is an ADR framework for architecture trade-off analysis?▼

An ADR framework for architecture trade-off analysis is a structured documentation process that guides context discovery, compares technology options, and records decisions. It ensures system design choices are justified by evaluating trade-offs and referencing established patterns.

Can I use ADR templates for enterprise-scale systems and MVPs?▼

Yes, you can use ADR templates for both enterprise-scale systems and MVPs. The guided architecture decision framework is applicable across projects of varying scales, providing trade-off analysis and pattern references suitable for any system design or technology selection scenario.

How do I start an architecture decision record for my project?▼

To start an architecture decision record for your project, open the provided ADR templates and initiate the guided workflow. The process walks you through context discovery, trade-off analysis for technology selection, and pattern references to finalize the documentation scaffolding.

Why are ad-hoc architectural decisions a problem for system design?▼

Ad-hoc architectural decisions are a problem for system design because they lead to inconsistent designs and brittle ADRs. By using a structured ADR framework with guided context discovery and trade-off analysis, you ensure robust rationale and consistent technology selection across projects.