ADR Authoring

by magnus919

ADR Authoring is a Writing skill for Claude Code, published by magnus919 in agent-skills.

40 stars6 forkson magnus919/agent-skillsAdded 2026/07/18+18% in starsRepository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsagentskillsai-agentsautomationllm

Install in seconds

Install ADR Authoring

Copy ADR Authoring into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/magnus919/agent-skills/tree/main/adr-authoring ~/.claude/skills/adr-authoring

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/magnus919/agent-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: adr-authoring/SKILL.md in magnus919/agent-skills
Installs to: ~/.claude/skills/adr-authoring
Collection: One of 33 skills cataloged from this repository
Category: Writing — 1361 skills

What ADR Authoring does

Write, review, and maintain architecture decision records with clear context, alternatives, consequences, and lifecycle governance. Use when a consequential technical decision must remain understandable.

ADR Authoring is cataloged under Writing on DirSkills. ADR Authoring comes from a repository tagged agent-skills, agentskills, ai-agents, automation and llm.

Documentation

README

Excerpt

ADR Authoring

Architecture Decision Records for capturing design rationale. ADRs supply the temporal dimension — decisions over time — that structure-only views (C4) miss.

ADR-to-Pyramid Mapping

ADR State	Pyramid Layer	Path
Navigation index	L1 (Summary)	01-summary/adr-index.md
Active ADRs	L2 (Analysis)	02-analysis/architecture-decisions/ADR-NNN.md
Superseded ADRs	L3 (Dossiers)	03-dossiers/adr-superseded.md

Without ADRs, an agent sees a snapshot of the structure but cannot reconstruct the path that led to it. Active ADRs in L2 provide the decision rationale. Superseded ADRs in L3 preserve the history of rejected alternatives.

ADR Lifecycle

ADRs progress through six stages, each with a gate criterion:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about ADR Authoring

What else does magnus919 publish alongside ADR Authoring?
ADR Authoring is one of 33 skills that DirSkills catalogs from magnus919/agent-skills, the repository it ships in. Its siblings there include API Design and Evolution, ARR CLI and Agent Council. Each one is a separate skill with its own page in this directory, installs the same way ADR Authoring does, and is maintained by magnus919 in that same repository. The rest of the collection is listed on the magnus919/agent-skills page.
How does ADR Authoring compare to other Writing skills?
ADR Authoring ranks #1242 by stars among the 1361 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of ADR Authoring against them. Open each page to compare what they document and how they install.