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.