architecture

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

6|2|Updated Jul 8, 2012
One-click install
npx skills add https://github.com/athal7/dotfiles --skill architecture-athal7
Or copy as Structured Prompt for Agent
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.