adr-write

Create, edit, and supersede numbered ADRs in docs/adr/ using the Michael Nygard template.

11|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/thrawn01/claude-dotfiles --skill adr-write-thrawn01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-write
Source: https://github.com/thrawn01/claude-dotfiles/tree/main/skills/adr-write
Command: npx skills add https://github.com/thrawn01/claude-dotfiles --skill adr-write-thrawn01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs provide a lightweight, standardized mechanism to record architecture decisions as numbered documents, ensuring decisions are preserved, traceable, and easy to revisit over time.

Core Features & Use Cases

  • Create new ADRs following the Michael Nygard template in docs/adr/.
  • Edit existing ADRs with minor changes or supersede older decisions with a new ADR.
  • Handle multi-step requests in a single invocation, while ensuring clarity and minimization of unnecessary changes.

Quick Start

Create a new ADR in docs/adr/ with a concise, declarative decision summary.

Frequently Asked Questions about adr-write

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

FAQPage Schema
How do I document software architecture decisions as ADRs?

Architecture decisions are documented as numbered ADRs using the Michael Nygard template, capturing context, decision, and status to ensure choices remain traceable over time within your project.

When should I supersede an architecture decision record instead of editing it?

Supersede an architecture decision record when reversing or significantly altering a prior choice, linking the new ADR to the old one, and use minor edits only for small clarifications that do not change the original decision.

What is the Michael Nygard ADR template format?

The Michael Nygard ADR template is a lightweight document structure that records architecture decisions by numbering them sequentially and outlining the context, decision, and consequences to preserve traceability over time.

Where are architecture decision records stored in a project?

Architecture decision records are output as numbered files in the docs/adr/ directory, maintaining a numeric sequence that preserves chronological order and ensures decisions are easy to revisit over time.

Can I create and supersede architecture decisions in a single request?

Yes, you can handle multi-step requests in a single invocation to create new architecture decision records and supersede older ones, ensuring clarity while minimizing unnecessary changes to your documentation.