architecture-decision-record SKILL.md skillA

architecture-decision-record from kesslernity/awesome-copilot-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kesslernity/awesome-copilot-agent-skills/architecture-decision-record@git:20260917.f14a4fb

Pins git:20260917.f14a4fb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kesslernity/awesome-copilot-agent-skills
Path
skills/executive/architecture-decision-record/SKILL.md
Versions recorded
2
Latest version
git:20260917.f14a4fb, committed Sep 17, 2026
First version recorded
Sep 16, 2026
Size
10,818 bytes
Repository stars
15
License
CC-BY-SA-4.0

Drafts an architecture or design decision record (ADR) from the discussion notes, design review minutes, chat threads and diagram descriptions the user provides: context, decision drivers, options considered with arguments as stated, the decision as the group worded it, consequences and a review date, with every factual claim tagged evidenced, asserted or UNKNOWN so unsupported claims are marked for the author to substantiate. Use when the user asks to "write an ADR…

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
Turn one design discussion into one DRAFT architecture decision record: context, drivers, the options with what was said for and against each, the decision as worded, consequences and review date. Every statement traces to a fragment or reads UNKNOWN; every factual claim carries a tag showing whether the notes evidence it or only assert it. The record captures the reasoning; it does not judge the design, verify any claim or approve the decision.

## When to use
Run when the user shares or points to design review notes, an architecture discussion, a technical thread or a design proposal and asks for an ADR, decision record or design decision log entry.
Do not use for a business or governance decision with no technical design (decision-memo-builder), for the change ticket that implements the decision (change-request-pack), or to choose the design.

## Inputs
Ask once for whatever is missing, in one message, then proceed with UNKNOWN.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kesslernity/awesome-copilot-agent-skills/architecture-decision-record@sha256:d54a29fc9cbfe6c8

The line at the top of this page pins the label git:20260917.f14a4fb, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zfeieny7yxpxo3nl.svg)](https://markdownregistry.com/a/art_zfeieny7yxpxo3nl)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 16, 2026 and Sep 17, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260917.f14a4fb latest2026-09-17 f14a4fb 10,818 BA view · diff
git:20260916.44af39e2026-09-16 44af39e 10,812 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10818 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kesslernity/awesome-copilot-agent-skills · 15 stars · license CC-BY-SA-4.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zfeieny7yxpxo3nl
GET https://markdownregistry.com/api/v1/resolve?ref=kesslernity/awesome-copilot-agent-skills/architecture-decision-record
GET https://markdownregistry.com/api/v1/blob/d54a29fc9cbfe6c89888e291a4b8110f43a152ba9b4fe9c505889c763e548c66

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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kesslernity/awesome-copilot-agent-skills

customer-feedback-theme-synthesis SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/customer-support/customer-feedback-theme-synthesis/SKILL.md · Synthesises a batch of customer feedback (survey answers, reviews, ticket and chat comments) into a DRAFT themed…
git:20260919.2af8b38 · audit A · 15 stars
escalation-summary SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/customer-support/escalation-summary/SKILL.md · Turns one long support ticket thread (helpdesk history, email chain, chat transcript, call notes) into a one-page DRAFT…
git:20260917.f14a4fb · audit A · 15 stars
ticket-triage-pack SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/customer-support/ticket-triage-pack/SKILL.md · Triages a batch of customer support tickets (helpdesk export, shared mailbox, chat transcripts, web forms) into one row…
git:20260917.f14a4fb · audit A · 15 stars
commitment-catcher SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/daily-briefings/commitment-catcher/SKILL.md · Sweeps the last 24 hours of email, chat messages and meeting transcripts for commitments in both directions, what the…
git:20260916.44af39e · audit A · 15 stars
custom-daily-brief SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/daily-briefings/custom-daily-brief/SKILL.md · Builds a role-tuned morning brief as a dated Markdown document covering emails that need replies, today's calendar with…
git:20260916.44af39e · audit A · 15 stars
project-dashboard-builder SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/dashboards-microapps/project-dashboard-builder/SKILL.md · Builds a self-contained single-file HTML project dashboard (status banner, milestones table, risks heat list, decisions…
git:20260917.f14a4fb · audit B · 15 stars
data-dictionary-builder SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-analytics/data-dictionary-builder/SKILL.md · Builds a DRAFT data dictionary from a schema export, table definition, sample rows or a partial existing dictionary…
git:20260917.f14a4fb · audit A · 15 stars
data-quality-issue-log SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-analytics/data-quality-issue-log/SKILL.md · Turns reported data problems (messages, tickets, meeting notes, complaints) into one DRAFT issue log: one row per issue…
git:20260919.2af8b38 · audit A · 15 stars
dataset-insight-pack SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-analytics/dataset-insight-pack/SKILL.md · Reads one spreadsheet, CSV export or pasted table together with the user's question and drafts an insight pack: a data…
git:20260916.44af39e · audit A · 15 stars
kpi-definition-sheet SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-analytics/kpi-definition-sheet/SKILL.md · Turns a list of KPIs or metrics into a DRAFT definition sheet: one row per KPI with the name as stated, formula quoted…
git:20260917.f14a4fb · audit A · 15 stars
document-deidentification-pass SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-privacy/document-deidentification-pass/SKILL.md · Proposes redactions of personal identifiers in pasted text or an attached document (names, contact details…
git:20260917.f14a4fb · audit A · 15 stars
dpia-draft-pack SKILL.md skill
kesslernity/awesome-copilot-agent-skills · skills/data-privacy/dpia-draft-pack/SKILL.md · Reads a project or processing description and returns a DRAFT data protection impact assessment pack: processing…
git:20260917.f14a4fb · audit A · 15 stars

Every file in kesslernity/awesome-copilot-agent-skills

Other files named architecture-decision-record

architecture-decision-record SKILL.md skill
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…
git:20260714.d9455b5 · audit A · 1,475 stars
architecture-decision-record SKILL.md skill
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…
git:20261011.3fb211c · audit A · 1,475 stars
architecture-decision-record SKILL.md skill
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…
v2.0.0 · audit A · 299 stars
architecture-decision-record SKILL.md skill
yonatangross/orchestkit · plugins/ork/skills/architecture-decision-record/SKILL.md · Nygard-format ADRs: context, decision, consequences, alternatives. Use when writing an ADR or recording an…
v2.0.0 · audit A · 299 stars
architecture-decision-record SKILL.md skill
dpalfery/kyber-weave · products/kyber-squad/skills/architecture-decision-record/SKILL.md · Capture an architectural decision as an ADR once it has been reached — a choice that constrains future work, had viable…
git:20261021.26ee555 · audit A · 23 stars
architecture-decision-record SKILL.md skill
stijnman/grok-custom-skills · .grok/skills/architecture-decision-record/SKILL.md · Document a significant technical decision with its context, alternatives, consequences, and status. Use for…
v1.0.0 · audit A · 14 stars
architecture-decision-record SKILL.md skill
jimyag/dotfiles · skills/architecture-decision-record/SKILL.md · 已有具体技术决策,需要判断是否记录 ADR,或创建、更新、替代 ADR 时使用。
git:20260905.751659e · audit A · 11 stars
architecture-decision-record SKILL.md skill
fattain-naime/engineering-docs · skills/architecture-decision-record/SKILL.md · Create a standalone Architecture Decision Record (ADR) for a single significant architectural decision. Captures…
git:20260717.2f82174 · audit A · 6 stars

Browse by kind, by grade A, or by owner.