Home / kesslernity / awesome-copilot-agent-skills · skills/executive/architecture-decision-record/SKILL.md · GitHub

architecture-decision-record skillA

architecture-decision-record is agent-read markdown (skill) from kesslernity/awesome-copilot-agent-skills: 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", "document the architecture .

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

# 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

Latest version
mdr add kesslernity/awesome-copilot-agent-skills/architecture-decision-record@git:20260917.f14a4fb
Exact content
mdr add kesslernity/awesome-copilot-agent-skills/architecture-decision-record@sha256:d54a29fc9cbfe6c8

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.

Badge

mdr badge

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

1 badge views in 30 days

Versions

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. Deterministic, no model, 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 · 5 stars · license CC-BY-SA-4.0 · pushed 2026-09-19 · 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 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.

More from kesslernity/awesome-copilot-agent-skills

customer-feedback-theme-synthesis 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, feedback forms) into a…
git:20260917.f14a4fb · audit A · 5 stars
escalation-summary 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 · 5 stars
ticket-triage-pack 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 · 5 stars
commitment-catcher 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 · 5 stars
custom-daily-brief 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 · 5 stars
project-dashboard-builder 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 · 5 stars
data-dictionary-builder 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 · 5 stars
data-quality-issue-log skill
kesslernity/awesome-copilot-agent-skills · skills/data-analytics/data-quality-issue-log/SKILL.md · Turns reported data problems (messages, tickets, meeting notes, a spreadsheet of complaints) into one DRAFT data…
git:20260917.f14a4fb · audit A · 5 stars
dataset-insight-pack 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 · 5 stars
kpi-definition-sheet 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 · 5 stars
document-deidentification-pass 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 · 5 stars
dpia-draft-pack 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 · 5 stars

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

Other files named architecture-decision-record

architecture-decision-record 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,392 stars
architecture-decision-record 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 · 283 stars
architecture-decision-record skill
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…
v2.0.0 · audit A · 283 stars
architecture-decision-record 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 · 11 stars

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