skills.rest
thkt
thktCOMMUNITY
Explore all skills by this author →
GitHub

adr

Generate Architecture Decision Records in MADR format with sequential numbering.

11|1|Updated Aug 6, 2025
Search Tags:#architecture#documentation#decision record#adr#madr
One-click install
npx skills add https://github.com/thkt/dotclaude --skill adr-thkt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/thkt/dotclaude/tree/main/.ja/skills/adr
Command: npx skills add https://github.com/thkt/dotclaude --skill adr-thkt

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation of Architecture Decision Records (ADRs) using the MADR format, including automatic numbering, simplifying the documentation of technical decisions.

Core Features & Use Cases

  • Automated Numbering: Automatically assigns sequential numbers to new ADRs.
  • MADR Format Compliance: Ensures ADRs adhere to the standard MADR template.
  • Use Case: When making a significant technical decision, like choosing a new database technology, use this Skill to quickly generate a properly formatted and numbered ADR to record the decision, its context, and consequences.

Quick Start

Use the adr skill to create a new architecture decision record with the title "Adopt PostgreSQL for user data".

Frequently Asked Questions about adr

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

FAQPage Schema
What is an Architecture Decision Record and when do I need to document one?▼

An Architecture Decision Record (ADR) documents significant technical decisions, architectural choices, and technology adoptions. You need an ADR when making choices like adopting a new database technology to record context and consequences.

How do I create an Architecture Decision Record with automatic sequential numbering?▼

To create an Architecture Decision Record, use the skill and provide a title like "Adopt PostgreSQL for user data". It generates a MADR formatted document with automatic sequential numbering for your project.

Does generating MADR format decision records require a specific directory structure?▼

Generating MADR format decision records requires creating or updating an `adr/` directory. The skill also requires a `README.md` index file within that directory to track the records.

What is the MADR format for architecture documentation?▼

The MADR format is a standard template for architecture documentation. This skill ensures your technical decisions adhere to MADR compliance, structuring the context, decision, and consequences consistently.

Are there limitations to using automated numbering for decision records?▼

Automated numbering assigns sequential numbers to new decision records. A limitation is that it requires maintaining an `adr/` directory and a `README.md` index file to function properly within your project.

Related Skills

Explore More Software Engineering Skills→
aifuunaifuun

manage-adr

Create, list, show, and validate ADR files with TL;DR format and YAML metadata.

Community
Advanced
mcj-codermcj-coder
1

documentation-as-code

Lint, spell-check, and validate links in Markdown documentation files.

Community
Intermediate
aydinsenturkkaydinsenturkk
3

sw-generate-knowledge

Generate formatted markdown knowledge files from official and community documentation.

Community
Advanced
BridgingIT-GmbHBridgingIT-GmbH
4

adr-writer

Automate MADR-compliant Architectural Decision Records with structured sections and 4-digit numbering.

Official
Advanced