skills.rest
alexandremendoncaalvaro
alexandremendoncaalvaroCOMMUNITY
Explore all skills by this author →
Website𝕏@xambitoGitHub

ad-adr

Draft an Architecture Decision Record from a conversation into a numbered ADR file.

728|16|Updated Mar 9, 2026
Search Tags:#architecture#templates#documentation#adr#governance#software-design#decision-record
One-click install
npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-adr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ad-adr
Source: https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime/tree/main/.agents/skills/ad-adr
Command: npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft an Architecture Decision Record (ADR) from a conversation, generating doc/adr/NNNN-<short-slug>.md with a structured template to capture decisions in a standardized format.

Core Features & Use Cases

  • Generates ADR skeleton with NNNN numbering from the existing doc/adr directory.
  • Enforces one-decision-per-ADR and a lifecycle: proposed → accepted → deprecated.
  • Extracts Context, Decision, Consequences, and Alternatives directly from the conversation to minimize drafting time.

Quick Start

Determine the next NNNN, create doc/adr if needed, fill the ADR template from this conversation, and write it to doc/adr/NNNN-<slug>.md with status proposed.

Frequently Asked Questions about ad-adr

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

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

This Skill drafts an Architecture Decision Record from your conversation by extracting Context, Decision, Consequences, and Alternatives. It writes a structured template to doc/adr/NNNN-slug.md with a proposed status.

What is the lifecycle status of an ADR when it is first generated?▼

The ADR lifecycle enforced by generation starts with a proposed status. The record then moves through accepted before reaching deprecated, ensuring one-decision-per-ADR governance is maintained throughout its lifecycle.

How are Architecture Decision Records numbered in the output directory?▼

Architecture Decision Records are numbered sequentially by determining the next available NNNN from the existing doc/adr directory. The Skill creates the directory if needed and writes the file using the NNNN-short-slug.md naming convention.

Can I document multiple software design decisions in a single ADR file?▼

You cannot document multiple software design decisions in a single ADR file. The generation process enforces a one-decision-per-ADR scope, ensuring each Architecture Decision Record remains focused on a single governance choice.

What sections are populated when drafting decision records from dialogue?▼

Drafting decision records from dialogue populates Context, Decision, Consequences, and Alternatives sections. The template also sets Date to today and asks the user to provide the Deciders before writing the file.

Related Skills

Explore More Software Engineering Skills→
alunduilalunduil
1

adr

Detect existing ADRs and scaffold new ones with correct numbering and structure.

Community
Intermediate
atomicinnovationatomicinnovation
30

review-adr

Review ADR YAML frontmatter and enforce lifecycle status transitions.

Official
Advanced
JmarquesJmarques

grill-with-docs

Refine plans and designs through interviews to produce ADRs and glossaries.

Community
Intermediate
HermeticOrmusHermeticOrmus

ADR Templates

Generate Markdown-based ADRs using MADR and Y-Statement templates.

Community
Basic