Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Architecture Decision Records
Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.
## Use this skill when
- Making significant architectural decisions
- Documenting technology choices
- Recording design trade-offs
- Onboarding new team members
- Reviewing historical decisions
- Establishing decision-making processes
## Do not use this skill when
- You only need to document small implementation details
- The change is a minor patch or routine maintenance
- There is no architectural decision to capture
## Instructions
1. Capture the decision context, constraints, and drivers.
2. Document considered options with tradeoffs.
3. Record the decision, rationale, and consequences.
4. Link related ADRs and update status over time.
## Core Concepts
### 1. What is an ADR?
An Architecture Decision Record captures:
- **Context**: Why we needed to make a decision
- **Decision**: What we decided
- **Consequences**: What happens as a result
### 2. When to Write an ADR
| Write ADR | Skip ADR |
|-----------|----------|
…
The line at the top of this page pins the label git:20260729.2d74b64, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_3baau6nivexbf2pz
GET https://markdownregistry.com/api/v1/resolve?ref=sickn33/agentic-awesome-skills/architecture-decision-records
GET https://markdownregistry.com/api/v1/blob/081585b1668ffa2691dc0616b86313c8329afda733d3dfb055f5ab6665d534e1
Your AI assistant 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.
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/00-andruia-consultant/SKILL.md · Usar al iniciar o mejorar un proyecto de IA: diagnostica código y restricciones, propone skills existentes y redacta…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/10-andruia-skill-smith/SKILL.md · Usar para crear o mejorar una skill de Andru.ia: define entradas y resultados, redacta SKILL.md con ejemplos y límites…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/20-andruia-niche-intelligence/SKILL.md · Usar tras definir el sector de un proyecto: prepara un dossier en español con contexto, normas aplicables, patrones UX…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/2slides-ppt-generator/SKILL.md · AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/3d-web-experience/SKILL.md · Use when building or debugging web 3D scenes, product configurators or portfolios with Three.js, React Three Fiber or…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/a4a/SKILL.md · Connect your AI agent to the A4A end-to-end encrypted agent-to-agent messaging network via local MCP tools or Python…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/aas-compose-stack/SKILL.md · Preserve the coding agent's explicit AAS skill selection as a validated stack and optional evidence.
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/aas-discover/SKILL.md · Discover AAS skills for an explicit task and compare their complete instructions without installing them.
wshobson/agents · plugins/documentation-generation/skills/architecture-decision-records/SKILL.md · Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation…
dicklesworthstone/pi_agent_rust · tests/ext_conformance/artifacts/agents-wshobson/documentation-generation/skills/architecture-decision-records/SKILL.md · Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation…
hashgraph-online/awesome-codex-plugins · plugins/Colin4k1024/tsp/skills/architecture-decision-records/SKILL.md · Capture architectural decisions made during Claude Code sessions as structured ADRs. Auto-detects decision moments…
francostino/opencode-skills-collection · bundled-skills/architecture-decision-records/SKILL.md · Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the…
rudycity/superagent · .agents/skills/architecture-decision-records/SKILL.md · Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation…
aicodedecode/awesome-muse-skills · skills-imported/architecture-decision-records/SKILL.md · Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the…
wankimmy/bossku-superpowers · skills/architecture-decision-records/SKILL.md · Capture architectural decisions made during Claude Code sessions as structured ADRs. Auto-detects decision moments…
