adr

Generate Architecture Decision Records with structured templates and linked numbering.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/maggit/claude-workspace --skill adr-maggit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/maggit/claude-workspace/tree/main/skills/adr
Command: npx skills add https://github.com/maggit/claude-workspace --skill adr-maggit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often scattered and hard to trace; this skill automates capturing, structuring, and linking ADRs to improve decision rationale and future maintenance.

Core Features & Use Cases

  • ADR generation and templating: auto-create ADR documents with consistent structure, including context, options, and consequences.
  • Decision tracking: locate next ADR number across common directories and link related ADRs for traceability.
  • Use Case: when a new architectural option is proposed, generate a properly formatted ADR documenting the problem, options considered, decision, and consequences.

Quick Start

Create a new ADR by providing the problem context and decision options, and the tool will generate a properly formatted ADR document.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I automate Architecture Decision Record creation for a software project?▼

You can automate ADR creation by providing the problem context and decision options, which generates a properly formatted Architecture Decision Record document with consistent structure, including context, options, and consequences.

What is the best way to maintain ADR traceability across multiple architecture decisions?▼

Maintain ADR traceability by locating the next ADR number across common directories and automatically linking related Architecture Decision Records to document technical decisions for future maintenance.

How do I structure an Architecture Decision Record to capture context and options?▼

Structure an Architecture Decision Record using a consistent template that documents the problem context, options considered, the final decision, and consequences to improve decision rationale and future maintenance.

Can I generate ADR documents for software architecture projects without manual numbering?▼

Yes, ADR generation automatically determines the next sequential numbering across common directories, ensuring consistent indexing and traceability for software architecture projects without manual numbering.

When do I need to create an Architecture Decision Record for my technical decision?▼

Create an Architecture Decision Record when a new architectural option is proposed to capture and document the problem, options considered, decision, and consequences, preventing scattered decisions and ensuring traceability.