skills.rest
sddevelopment-be
sddevelopment-beOFFICIAL
Explore all skills by this author →
WebsiteGitHub

ARCHITECT ADR

Generate Proposed ADR Markdown files with decision sections and impact matrices.

13|3|Updated Nov 15, 2025
Search Tags:#design#architecture#documentation#adr#trade-offs#version-control#decision-record
One-click install
npx skills add https://github.com/sddevelopment-be/quickstart_agent-augmented-development --skill architect-adr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ARCHITECT ADR
Source: https://github.com/sddevelopment-be/quickstart_agent-augmented-development/tree/main/.claude/skills/architect-adr
Command: npx skills add https://github.com/sddevelopment-be/quickstart_agent-augmented-development --skill architect-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafts architecture decision records (ADRs) from analysis prompts to capture context, options, and trade-offs for architectural choices.

Core Features & Use Cases

  • Automatically generate a Proposed ADR from a structured input (TITLE, CONTEXT, FORCES, OPTIONS, PREFERRED, IMPACTS, NFRS, RELATED, ADR_REFS, etc.)
  • Produce a complete ADR document with sections: Context, Decision, Rationale, Envisioned Consequences, Considered Alternatives, and a risk/horizon assessment.
  • Output as a Markdown file at docs/architecture/adrs/ADR-XXX-<slug>.md suitable for version control and review.

Quick Start

Draft a Proposed ADR from the provided context and options.

Frequently Asked Questions about ARCHITECT ADR

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

FAQPage Schema
How do I document architecture trade-offs and decisions for version control?▼

An Architecture Decision Record (ADR) captures architectural choices by documenting context, options, and trade-offs. It produces a Markdown file with rationale and envisioned consequences, ready for version control.

What is the best way to generate an ADR from a multi-option architecture analysis?▼

The best way to generate an ADR is to process an analysis prompt detailing problems, forces, and options. This produces a Proposed ADR Markdown file complete with an option impact matrix and success metrics.

Can I automatically create an option impact matrix for my architecture decision records?▼

Yes, you can automatically create an option impact matrix for architecture decision records. Providing structured analysis inputs allows the system to generate the matrix alongside standard ADR sections like context and rationale.

What sections are included in an auto-drafted architecture decision record?▼

An auto-drafted architecture decision record includes sections for Context, Decision, Rationale, Envisioned Consequences, and Considered Alternatives. It also features an option impact matrix and success metrics.

Does drafting an ADR require structured input for non-functional requirements?▼

Drafting an ADR requires structured input covering non-functional requirements (NFRs), context, forces, and options. This structured analysis ensures the resulting decision record accurately captures all necessary trade-offs.

Related Skills

Explore More Software Engineering Skills→
Arbab1308Arbab1308

architecture

Guide architecture decisions with ADR documentation and trade-off analysis.

Community
Advanced
abdullah1854abdullah1854
1

pdf

Generate Markdown Architecture Decision Records from input fields.

Community
Advanced
AndurilCodeAndurilCode
7

architecture-evaluation

Evaluate software architectures by scoring quality attribute trade-offs and outputting an ADR.

Official
Advanced
Accelerated-InnovationAccelerated-Innovation
20

ui-adr-author

Draft UI Architecture Decision Records using governance templates.

Official
Advanced