adr is agent-read markdown (skill) from ulises-jeremias/agent-toolkit: WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# ADR — Architecture Decisions (WHAT)
**Template:** `references/default-template.md` — local reference for ADR structure and workflow.
## Default guardrails (before any final content)
1. Apply **`output-handshake`**: confirm **where** the final ADR will be recorded and that a **human** will review.
2. Then follow the steps below.
## When to use
Use **`decision-log`** for lightweight product/project/operational decisions and **`agreement`** for explicit commitments or terms among parties. Use this ADR skill only for durable architecture or technical decisions.
- A change has **long-term** architectural, security, data-model, or cost impact.
- You need **options with pros/cons** and a **record** for future readers (and for supersession later).
- The project needs decisions linked to PRDs, TRDs, tasks, PRs, diagrams, or other supporting artifacts.
## Instructions
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_jn4owb6b6wix5zye
GET https://markdownregistry.com/api/v1/resolve?ref=ulises-jeremias/agent-toolkit/adr
GET https://markdownregistry.com/api/v1/blob/d2f18d4e585066231f9a296ab0084e1e54b74b1afade7c4006761250536fe73b
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove the one fact it's safe…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/bug/SKILL.md · WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/c4-model/SKILL.md · WHAT — C4 model methodology (Context, Container, Component, Code) guidance — what to draw at each level, when, and how…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/chrome-devtools/SKILL.md · Use Chrome DevTools MCP to control and inspect a live Chrome instance for network, console, performance, rendering, and…
sd0xdev/sd0x-harness · skills/adr/SKILL.md · Write an Architecture Decision Record (ADR) for a feature — Context / Decision / Status / Consequences / Alternatives…
byerlikaya/claude-starter-kit · plugin/skills/adr/SKILL.md · Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse.
Written under…
byerlikaya/claude-starter-kit · claude-starter/skills/adr/SKILL.md · Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse.
Written under…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
jdanigo/hydraia · skills/adr/SKILL.md · Use when a design decision is made that is expensive to reverse, affects multiple components, or rejects a plausible…
