architecture

Document architectural decisions with structured ADR-style analysis and scoring.

6|2|Updated Jul 8, 2012

Search Tags:#architecture #adr #governance #system-design #tradeoffs #design-decision

Ready to run

npx skills add https://github.com/athal7/dotfiles --skill architecture-athal7

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/athal7/dotfiles/tree/main/skills/architecture
Command: npx skills add https://github.com/athal7/dotfiles --skill architecture-athal7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Align teams on architectural choices by providing a structured, auditable process that surfaces options, criteria, and rationales before implementation.

Core Features & Use Cases

Structured decision gathering: capture problem context, constraints, and options in a transparent table.
ADR-driven workflow: generate a formal decision record with context, decision, and consequences for future readers.
Guardrails and escalation: surface prerequisites, anti-patterns, and escalation when decisions cross boundaries or require stakeholder input.

Quick Start

Describe a design decision problem and constraints to initiate the structured ADR workflow.

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 my software design?▼

You document architectural decisions by producing a structured ADR-style analysis that captures problem context, constraints, and options in a transparent table to align teams on design choices.

What is an ADR and how does it help with system design tradeoffs?▼

An ADR is a formal architecture decision record that surfaces options, criteria, and rationales before implementation, providing an auditable process for evaluating system design tradeoffs and data models.

How do I create a decision matrix for evaluating multiple module interfaces?▼

You create a decision matrix by running prerequisite checks and scoring multiple viable options for module interfaces, generating a structured evaluation to guide your architectural governance.

Can I use this structured ADR workflow for deployment tradeoffs?▼

Yes, the structured ADR workflow is applicable to software design with multiple viable options across modules, interfaces, data models, and deployment tradeoffs to produce a reusable decision record.

When should I escalate an architectural design decision to stakeholders?▼

You escalate architectural design decisions when they cross boundaries or require stakeholder input, using the built-in guardrails and escalation guidance to surface anti-patterns and prerequisites.