Document a significant technical decision with its context, alternatives, consequences, and status. Use for: architecture decision record, ADR, technical decision log, technology choice.
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 Record
## Purpose
Write a concise, durable record of a material technical decision so future contributors can understand the context, trade-offs, and consequences without reconstructing the discussion.
## Workflow
1. Confirm that a real architecture or technology decision is being made; do not create an ADR for routine implementation detail.
2. Assign a stable identifier and a short active-voice title.
3. Describe the context, constraints, decision drivers, and relevant stakeholders.
4. Record the chosen decision precisely, including the intended scope and status: proposed, accepted, deprecated, or superseded.
5. Compare meaningful alternatives and explain the evidence or trade-offs behind the choice.
6. State positive, negative, and neutral consequences, including migration or operational effects.
7. Link related decisions or supporting evidence when available, then deliver the ADR for review.
## Output template
Use these headings: **Status**, **Context**, **Decision**, **Alternatives considered**, **Consequences**, and **References**. Keep the record self-contained and concise.
## Quality boundaries
…
The line at the top of this page pins the label v1.0.0, 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_rmxxhufa32guq26w
GET https://markdownregistry.com/api/v1/resolve?ref=stijnman/grok-custom-skills/architecture-decision-record
GET https://markdownregistry.com/api/v1/blob/cb89eb8389c0afa3a226917eaaf1cb366d1dd344e858b5aa0ec82431989af363
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.
stijnman/grok-custom-skills · .grok/skills/adaptive-workflow-composer/SKILL.md · Composes multi-step agent workflows from goals and available skills. Use for: compose workflow, plan steps, adaptive…
stijnman/grok-custom-skills · .grok/skills/ai-share-extractor-v4/SKILL.md · Extracts shareable insights from long agent sessions for export. Use for: extract shares, shareable summary, export…
stijnman/grok-custom-skills · .grok/skills/auto-skill-resolver/SKILL.md · Plan and coordinate skill-library improvements by identifying gaps, overlaps, and the safest next action. Use for…
stijnman/grok-custom-skills · .grok/skills/auto-tester/SKILL.md · Runs validation tests on code, skills, or outputs after changes. Use for: run tests, auto test, validate changes, check…
mohitagw15856/pm-claude-skills · exports/openclaw/architecture-decision-record/SKILL.md · Create an Architecture Decision Record (ADR) for any technical decision. Use when asked to document a technical…
mohitagw15856/pm-claude-skills · i18n/es/skills/architecture-decision-record/SKILL.md · Crea un Registro de Decisión de Arquitectura (ADR) para cualquier decisión técnica. Úsalo cuando necesites documentar…
yonatangross/orchestkit · src/skills/architecture-decision-record/SKILL.md · ADR templates in the Nygard format with context, decision, consequences, and alternatives. Use when writing ADRs…
yonatangross/orchestkit · plugins/ork/skills/architecture-decision-record/SKILL.md · ADR templates in the Nygard format with context, decision, consequences, and alternatives. Use when writing ADRs…
kesslernity/awesome-copilot-agent-skills · skills/executive/architecture-decision-record/SKILL.md · Drafts an architecture or design decision record (ADR) from the discussion notes, design review minutes, chat threads…
fattain-naime/engineering-docs · skills/architecture-decision-record/SKILL.md · Create a standalone Architecture Decision Record (ADR) for a single significant architectural decision. Captures…
