dough-adr-awareness SKILL.md skillA

dough-adr-awareness from nerds-odd-e/doughnut is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nerds-odd-e/doughnut/dough-adr-awareness@git:20260909.3784459

Pins git:20260909.3784459 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nerds-odd-e/doughnut
Path
.agents/skills/dough-adr-awareness/SKILL.md
Versions recorded
4
Latest version
git:20260909.3784459, committed Sep 9, 2026
First version recorded
Sep 8, 2026
Size
7,496 bytes
Repository stars
50
License
MIT

Use and cite this project's current Accepted Architectural Decision Records for architecture-shaped work, follow supersession, surface conflicts instead of silently drifting, and preserve human ownership of decisions and exceptions. Use when a task mentions ADRs or architectural constraints, may reverse an existing decision, or crosses architecture areas defined by this project.

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

# ADR awareness

Keep architecture-shaped work consistent with this project's current
Accepted ADRs without taking decision authority from humans.

## Required project context

Resolve the following context from the repository's own guidance as needed for
the current request; ask the human only for a missing value that affects it:

- the repository-relative ADR store and index or catalog path;
- the fields that authoritatively classify an ADR as Proposed, Accepted,
  Rejected, or Superseded, and the human-owned rule for resolving disagreement
  between those fields;
- the filename conventions and supersession-link convention;
- the project's definition of architecture-shaped work and the areas governed
  by each ADR;
- the durable place to record an explicitly approved exception;
- the human advice, announcement, approval, rejection, and supersession
  process; and
- the precedence between ADR guidance and any planning or delivery workflow.

The proposal template is required only when the human asks for proposal-drafting
help. Do not assume a template, ADR path, status syntax, or exception trail from
another project.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nerds-odd-e/doughnut/dough-adr-awareness@sha256:169a108c845c252f

The line at the top of this page pins the label git:20260909.3784459, 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_epvoyyo7jq5u6fca.svg)](https://markdownregistry.com/a/art_epvoyyo7jq5u6fca)

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

Versions

The registry has recorded 4 versions of this file, between Sep 8, 2026 and Sep 9, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260909.3784459 latest2026-09-09 3784459 7,496 BA view · diff
git:20260908.f2be7c02026-09-08 f2be7c0 7,581 BA view · diff
git:20260908.6a78e4b2026-09-08 6a78e4b 7,495 BA view · diff
git:20260908.290d1312026-09-08 290d131 7,885 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 (7496 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

nerds-odd-e/doughnut · 50 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_epvoyyo7jq5u6fca
GET https://markdownregistry.com/api/v1/resolve?ref=nerds-odd-e/doughnut/dough-adr-awareness
GET https://markdownregistry.com/api/v1/blob/169a108c845c252f976b3c499b493567ca7bce526d8cf9d8c086d7ecdb4fc963

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 nerds-odd-e/doughnut

backend-code SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-code/SKILL.md · Backend Java production code, Spring Boot controllers/services/repositories, controller return values, imports, schema…
git:20260928.32163ae · audit A · 50 stars
backend-testing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-testing/SKILL.md · Backend Java tests, controller-level stable-boundary tests, JUnit, @Nested, MakeMe builders, @Transactional…
git:20261003.8204a88 · audit A · 50 stars
backend SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend/SKILL.md · Backend Java — Spring Boot controllers/services, JUnit controller tests, MakeMe. Read this first for any backend work…
git:20260918.3a97b0e · audit A · 50 stars
cli SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cli/SKILL.md · related to donut CLI. Use when working on donut-cli.
git:20260916.b334104 · audit A · 50 stars
cloud-vm-setup SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cloud-vm-setup/SKILL.md · Set up and run the Donut dev environment on Cursor Cloud VM (no Nix). Use when working on Cloud VM, running tests on…
git:20261101.6bb5c5b · audit B · 50 stars
database-erd SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/database-erd/SKILL.md · Regenerate docs/database-erd.md from MySQL information_schema (Mermaid ERD: foreign keys and key columns). Use after…
git:20260826.0b913a6 · audit A · 50 stars
db-migration SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/db-migration/SKILL.md · Database migration, Flyway, SQL migrations, schema changes, database versioning, migration files, squashing historical…
git:20260928.428ed03 · audit A · 50 stars
dough-bug-fixing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-bug-fixing/SKILL.md · Resolves a reported discrepancy, defect, or regression by gathering expected versus actual behavior and passing the…
git:20261011.8ac439b · audit A · 50 stars
dough-execute-plan SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execute-plan/SKILL.md · Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless…
git:20261031.b173027 · audit A · 50 stars
dough-execution-retrospective SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execution-retrospective/SKILL.md · Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits…
git:20261031.b173027 · audit A · 50 stars
dough-land SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-land/SKILL.md · Dough Land lands everything in one reviewed checkout on the authorized remote trunk: commits all of its changes…
git:20261028.db35405 · audit A · 50 stars
dough-maintain-findings SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-maintain-findings/SKILL.md · Adopts supplied, approved DD-NNN to ODF-NNN finding-name mappings in this project's DearDough.md while preserving…
git:20260912.fc98c0d · audit A · 50 stars

Every file in nerds-odd-e/doughnut

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