skills.rest
angelo-v
angelo-vCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr

Creates Architecture Decision Records in MADR format through interactive questionnaires.

Updated May 12, 2026
Search Tags:#documentation#markdown#adr#software architecture#technical decisions#architecture decision record#madr
One-click install
npx skills add https://github.com/angelo-v/pi-kit --skill adr-angelo-v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/angelo-v/pi-kit/tree/main/packages/software-development/skills/adr
Command: npx skills add https://github.com/angelo-v/pi-kit --skill adr-angelo-v

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documenting architectural decisions is often skipped or done inconsistently, leaving teams without a record of why technical choices were made. This Skill guides you through a structured interview and produces a properly formatted MADR Architecture Decision Record. ## Core Features & Use Cases - Interactive Interview: Collects title, status, context, decision drivers, options, rationale, and consequences through a questionnaire tool. - Automatic ADR Directory Detection: Finds existing ADR directories in the project or lets you specify a custom path. - MADR-Compliant Output: Generates files following the NNNN-short-title.md naming convention with automatic sequence numbering. - Use Case: After deciding to adopt PostgreSQL over MongoDB, run this Skill to record the context, considered options, trade-offs, and rationale as a permanent, numbered ADR in your repository. ## Quick Start Create a new architecture decision record documenting why we chose PostgreSQL as our database.

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?▼

Run the skill and answer the interactive questionnaire covering title, status, context, decision drivers, considered options, chosen option, rationale, and consequences. The create_adr tool then writes a MADR-formatted Markdown file with automatic sequence numbering.

What is the MADR format for architecture decisions?▼

MADR (Markdown Architectural Decision Records) is a lightweight template for documenting decisions with fields for context, decision drivers, considered options, outcome, and consequences. Files follow the NNNN-short-title.md naming convention with zero-padded sequence numbers.

Where are ADR files stored in a project?▼

The skill calls detect_adr_dir to find existing ADR directories in the project and offers them as options. You can also specify a custom path, and the chosen directory is passed to create_adr when writing the file.

Can I edit or delete an accepted ADR later?▼

Accepted ADRs should never be deleted, only superseded by a newer ADR. You can link related ADRs using relative Markdown links to preserve the decision history.

What statuses can an architecture decision record have?▼

An ADR can be marked as proposed, accepted, deprecated, or superseded. Proposed means not yet decided, accepted means agreed and in effect, deprecated means no longer recommended, and superseded means replaced by another ADR.

Related Skills

Explore More Software Engineering Skills→
windyroadwindyroad
4

wr-architect:create-adr

Create MADR 4.0 Architecture Decision Records in docs/decisions.

Official
Advanced
orbtyapporbtyapp
1

architecture

Generate structured architecture documentation with SYSTEM_OVERVIEW, API_DESIGN, DATA_MODEL, SECURITY, and ADRs.

Official
Basic
RafayelGardishyanRafayelGardishyan

using-adr-plugin

Search and traverse Architecture Decision Records in Obsidian vaults.

Community
Advanced
jeremyaryjeremyary
7

adr

Create structured Markdown Architecture Decision Records in the plans/adr/ directory.

Community
Intermediate