adr

Create and manage MADR-compliant Architecture Decision Records across projects.

Updated Jun 12, 2025
One-click install
npx skills add https://github.com/stevoland/dotfiles --skill adr-stevoland
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/stevoland/dotfiles/tree/main/opencode/skill/adr
Command: npx skills add https://github.com/stevoland/dotfiles --skill adr-stevoland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR management centralizes Architecture Decision Records to standardize how teams capture decisions, rationale, and status, reducing drift and misalignment across projects.

Core Features & Use Cases

  • ADR creation and lifecycle management: draft, publish, update status, and supersede as projects evolve.
  • Discovery and reading: locate relevant ADRs by topic, read decisions and rationales, and assess alignment with current work.
  • Commit integration: reference ADRs in code changes to document rationale in VCS history.

Quick Start

Create the first ADR for a significant architecture decision using the MADR template and store it under docs/ADR/.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I manage architectural decision records across multiple projects?

Manage architectural decision records by centralizing ADR creation, reading, and status updates to standardize rationale and reduce drift across projects. This tracks decision lifecycles from drafting through supersession.

What is the MADR template for software architecture decisions?

The MADR template is a structured format for capturing architectural decisions, rationale, and status. It standardizes ADR documentation to reduce misalignment across teams and repositories.

How do I integrate ADRs into git commits?

Integrate ADRs into git commits by referencing relevant architectural decision records within your code changes. This documents the decision rationale directly in VCS history for future context.

Where should I store architecture decision records in my repository?

Store architecture decision records under the docs/ADR/ directory in your repository. This centralizes ADRs for easy discovery, reading, and alignment assessment during development.

How do I track the lifecycle of an architectural decision as it evolves?

Track architectural decision lifecycles by drafting, publishing, updating status, and superseding ADRs as projects evolve. This maintains accurate historical context and alignment.

Can I use this ADR management skill without any external dependencies?

Yes, you can use this ADR management skill without external dependencies. It operates independently to create, locate, and align architecture decision records using the MADR-compliant template.