adr SKILL.md skillA

adr from p2p2sp/p2p2.claude is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add p2p2sp/p2p2.claude/adr@git:20260924.1101a9b

Pins git:20260924.1101a9b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
p2p2sp/p2p2.claude
Path
docs/archive/superdev/skills/adr/SKILL.md
Versions recorded
1
Latest version
git:20260924.1101a9b, committed Sep 24, 2026
Size
5,324 bytes
Repository stars
8
License
MIT

Judges an intent interview's confirmed decisions against the three ADR criteria (hard to reverse, surprising without context, the result of a real trade-off) and returns a one-paragraph architecture decision record for each decision that passes all three. Invoked by the `intent` skill only - never directly, never by the user, never mid-interview, never from a spec, plan, build or review.

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 judge

Decide which confirmed decisions of the interview deserve an architecture decision record, offer the user a finished draft of each one, and return what was accepted as a ready `## ADR` section. Zero offers is the ordinary outcome, not a failure.

# Input

`$ARGUMENTS` sets the scope:
- empty -> judge every confirmed decision of the interview.
- one line `decision: <n>` -> judge that decision alone and ignore every other one.

The material is the conversation itself: the decisions, the alternatives weighed against them, and the reasons the user gave for the winner. None of it sits in a file - the intent template keeps rationale out on purpose - so reconstruct nothing from disk.

The single file access is the supersede check, and only for a decision that already passed `# Judge`: `Glob docs/adr/*.md`, then `Read` a match whose subject is that same decision. No file, no match, or no `docs/adr/` at all -> skip the check and write no `Supersedes:` line.

# Judge

All three criteria hold, or there is no offer. One of them missing -> drop the decision silently: no message to the user, no block, no mention in the output.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add p2p2sp/p2p2.claude/adr@sha256:52e7732f2515e5fe

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

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

Versions

The registry has recorded 1 version of this file, committed on Sep 24, 2026.

versioncommittedcommitsizeaudit
git:20260924.1101a9b latest2026-09-24 1101a9b 5,324 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 (5324 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

p2p2sp/p2p2.claude · 8 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dlmszw5m7iuokhub
GET https://markdownregistry.com/api/v1/resolve?ref=p2p2sp/p2p2.claude/adr
GET https://markdownregistry.com/api/v1/blob/52e7732f2515e5fe6dd3b8142dae9b5c98500b50854d241b4a2972c59610f40f

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 p2p2sp/p2p2.claude

CLAUDE.md CLAUDE.md file
p2p2sp/p2p2.claude · CLAUDE.md
git:20261021.e0a0e76 · audit A · 8 stars
signoz SKILL.md skill
p2p2sp/p2p2.claude · devtools/skills/signoz/SKILL.md · SigNoz logs, dashboards and alerts through its HTTP API.
git:20261016.1921705 · audit A · 8 stars
CLAUDE.md@docs CLAUDE.md file
p2p2sp/p2p2.claude · docs/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
CLAUDE.md@docs/archive/superdev CLAUDE.md file
p2p2sp/p2p2.claude · docs/archive/superdev/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
CLAUDE.md@docs/archive/superdev/skills CLAUDE.md file
p2p2sp/p2p2.claude · docs/archive/superdev/skills/CLAUDE.md
git:20261007.aaa7079 · audit A · 8 stars
e2e SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/e2e/SKILL.md · Generate and locally verify Playwright tests for the scenarios of one docs/qa handoff file, then commit them for CI.
git:20260924.1101a9b · audit A · 8 stars
executor SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/executor/SKILL.md · Runs ONE build, test, lint, type-check or other shell command in a forked context and returns a short verdict - the…
git:20260924.1101a9b · audit A · 8 stars
intent SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/intent/SKILL.md · You MUST ALWAYS use this skill every time a user wants to do something creative - a new idea, a new feature, build…
git:20260924.1101a9b · audit A · 8 stars
phases-reviewer SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/phases-reviewer/SKILL.md · Invoked only by phases skill.
git:20260924.1101a9b · audit A · 8 stars
phases SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/phases/SKILL.md · Cuts one confirmed intent into ordered phases, saves phases.md plus one intent.md per phase, and resumes a phased run…
git:20260924.1101a9b · audit A · 8 stars
setup SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/setup/SKILL.md · Setup superdev environment.
git:20260924.1101a9b · audit A · 8 stars
simplebuild SKILL.md skill
p2p2sp/p2p2.claude · docs/archive/superdev/skills/simplebuild/SKILL.md · Build orchestrator for an approved SimplePlan (a plan without a Spec line). Use it ONLY when the approved plan's body…
git:20260924.1101a9b · audit A · 8 stars

Every file in p2p2sp/p2p2.claude

Other files named adr

adr SKILL.md skill
sd0xdev/sd0x-harness · skills/adr/SKILL.md · Write an Architecture Decision Record (ADR) for a feature — Context / Decision / Status / Consequences / Alternatives…
git:20260811.d9a8bca · audit A · 194 stars
adr SKILL.md skill
jellydn/my-ai-tools · configs/amp/plugins/my-ai-tools-skills/skills/adr/SKILL.md · Record architecture decisions with ADRs — captures why, alternatives considered, and consequences
git:20260814.d1987f5 · audit A · 123 stars
adr SKILL.md skill
jellydn/my-ai-tools · skills/adr/SKILL.md · Record architecture decisions with ADRs — captures why, alternatives considered, and consequences
git:20260708.83bb509 · audit A · 123 stars
adr SKILL.md skill
kerberosclaw/kc_ai_skills · adr/SKILL.md · Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to…
v0.3.1 · audit A · 79 stars
adr SKILL.md skill
drafthq/draft · skills/adr/SKILL.md · Create and manage Architecture Decision Records. Documents significant technical decisions with context, alternatives…
git:20260819.fda278e · audit A · 40 stars
adr SKILL.md skill
byerlikaya/claude-starter-kit · kit/skills/adr/SKILL.md · Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse. Written under…
git:20260924.a457823 · audit A · 25 stars
adr SKILL.md skill
byerlikaya/claude-starter-kit · plugin/skills/adr/SKILL.md · Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse. Written under…
git:20260924.a457823 · audit A · 25 stars
adr SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
git:20260901.5d17d6a · audit A · 19 stars

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