# Adr Authoring

> Draft architecture decision records while keeping current guidance in ARCHITECTURE.md.

- Skill: `jwilger/adr-authoring` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jwilger/adr-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jwilger/adr-authoring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: jwilger (https://skillmd.com/u/jwilger)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jwilger/adr-authoring

---


# ADR Authoring

Use this skill when a change introduces or revises a significant architecture decision.

Rules:
- ADRs MUST record historical rationale.
- Current guidance MUST live in `docs/architecture/ARCHITECTURE.md`.
- Old ADRs MUST NOT be modified except for supersession metadata.
- Authors MUST apply `docs/guardrails/adrs.md`.