skills.rest
chris-prener
chris-prenerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr

Files, supersedes, audits, and indexes Architecture Decision Records in docs/adr/.

Updated Jul 29, 2026
Search Tags:#documentation#markdown#adr#audit#architecture decision record#design decisions#supersede
One-click install
npx skills add https://github.com/chris-prener/dev-kit --skill adr-chris-prener
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/chris-prener/dev-kit/tree/main/dev-kit/skills/adr
Command: npx skills add https://github.com/chris-prener/dev-kit --skill adr-chris-prener

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architectural decisions made during development get lost or re-litigated across sessions because there is no persistent, structured record of why a choice was made. This Skill maintains a durable, immutable log of Architecture Decision Records (ADRs) under docs/adr/ so settled decisions stay settled. ## Core Features & Use Cases - File new ADRs: Creates numbered ADR files from a template with status, date, context, decision, and consequences, and appends them to the index. - Supersede instead of edit: Replaces outdated decisions by filing a new ADR and marking the old one as superseded, preserving the historical record. - Audit and index refresh: Reports stale proposals, orphan ADRs, and broken epic references, and rebuilds the docs/adr/README.md index table. - Use Case: After deciding to adopt PostgreSQL over SQLite in a design discussion, invoke this Skill to file ADR-0007 capturing the context, alternatives, and consequences, with the index updated automatically. ## Quick Start Ask Claude to file an ADR documenting the architectural decision you just made, including the context, the decision, and its consequences.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Architecture Decision Record?▼

Provide the decision title, context, decision statement, alternatives, and consequences. The Skill copies the ADR template to docs/adr/ADR-NNNN-title.md with the next monotonic number, fills in the frontmatter, and appends a row to the index.

How do I change an existing ADR?▼

Accepted ADRs are immutable, so you supersede rather than edit. The Skill files a new ADR with the revised decision and marks the old one's status as superseded by the new ADR number, leaving the original body untouched.

When should I not write an ADR?▼

Skip ADRs for process or convention changes, implementation details that don't alter the architectural posture, and decisions still in flight. File when a decision is accepted, unless deliberately using status: proposed.

What does an ADR audit check for?▼

The audit counts ADRs by status, flags proposed ADRs older than 30 days, flags references to closed or missing epics, and identifies orphan ADRs not referenced from any other ADR, epic, or project doc.

Does this Skill auto-generate ADRs from commits or PRs?▼

No. Auto-generating ADRs from PR descriptions or commits is explicitly out of scope. The Skill files ADRs from decision content you provide and only uses gh CLI commands as its allowed tooling.

Related Skills

Explore More Software Engineering Skills→
aaaa47080aaaa47080
4

architecture-decision-records

Records architectural decisions with context, alternatives, rationale, and consequences in a structured format.

Community
Advanced
thilthpc01208thilthpc01208

create-stories

Break an epic into testable stories with aligned ADRs and TR-IDs.

Community
Advanced
meisijiyameisijiya

update-project-meta

Update project documentation files with canonical formatting and conflict detection.

Community
Advanced
ChaiWithJaiChaiWithJai
1

technical-decision-record

Create Architecture Decision Records with standardized sections for context, constraints, options, decisions, and consequences.

Community
Intermediate