skills.rest
sho7650
sho7650COMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr

Create, list, supersede, and deprecate Architecture Decision Records.

Updated Feb 5, 2026
Search Tags:#architecture#decision making#documentation#adr#record keeping#technical decisions
One-click install
npx skills add https://github.com/sho7650/tech-news-curator --skill adr-sho7650
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/sho7650/tech-news-curator/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/sho7650/tech-news-curator --skill adr-sho7650

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating, updating, and managing Architecture Decision Records (ADRs), ensuring consistent documentation of technical decisions.

Core Features & Use Cases

  • Create New ADRs: Generates new ADR files with a unique number and title, prompting for essential details like context, options, and outcomes.
  • List ADRs: Provides a clear overview of all existing ADRs, including their number, title, status, and date.
  • Update ADR Status: Allows for marking ADRs as 'Superseded' or 'Deprecated' with relevant details.
  • Use Case: When your team needs to decide on a new database technology, use this Skill to create a formal ADR documenting the problem, evaluated options (e.g., PostgreSQL vs. MongoDB), and the final decision with justifications.

Quick Start

Use the adr skill to create a new architecture decision record about choosing a new logging framework.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document technical decisions for my software architecture?▼

Architecture Decision Records document technical decisions by capturing context, evaluated options, and final outcomes. This Skill generates structured ADR files with unique numbers and titles to maintain a clear history of architectural choices.

How do I create a new Architecture Decision Record for choosing a framework?▼

Creating an Architecture Decision Record involves interactively providing context, options, and outcomes. The Skill generates a new ADR file with a unique number and title, storing the formal documentation of your framework evaluation and selection.

Can I update the status of an Architecture Decision Record when a technology is deprecated?▼

Yes, you can update an Architecture Decision Record by marking it as 'Superseded' or 'Deprecated'. The Skill modifies existing ADR files to reflect changes in technical decisions, adding relevant details about the replacement or retirement.

How do I list existing Architecture Decision Records in a project?▼

Listing Architecture Decision Records provides a clear overview of all documented technical decisions. The Skill outputs each record's number, title, current status, and date, allowing quick reference of your project's architectural history.

Do I need to set up a specific directory structure to manage ADRs?▼

Managing ADRs requires a specified directory structure where the Skill creates and updates ADR files. This ensures Architecture Decision Records remain consistently organized within your software development project's documentation hierarchy.

Related Skills

Explore More Software Engineering Skills→
MakisuoMakisuo
1.6k

clickhousectl-local-dev

Install and configure a local ClickHouse environment with clickhousectl.

Community
Intermediate
Ikki-GroupIkki-Group

create-architectural-decision-record

Generate standardized Architectural Decision Records from structured inputs.

Official
Advanced
ThiagoVitaleThiagoVitale

gsd-complete-milestone

Archive completed milestones and update project documentation for the next version.

Community
Advanced
Logos-LiberLogos-Liber
17

documentation-tools

Compare static site generators and documentation platforms for technical documentation workflows.

Official
Intermediate