skills.rest
PL-Coding-GmbH
PL-Coding-GmbHOFFICIAL
Explore all skills by this author →
WebsiteGitHub

architecture-decision-record

Create Architectural Decision Records using the MADR template.

6|Updated Jun 24, 2026
Search Tags:#software architecture#ADR#MADR#architecture decision record#decision documentation
One-click install
npx skills add https://github.com/PL-Coding-GmbH/Skills --skill architecture-decision-record-pl-coding-gmbh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-record
Source: https://github.com/PL-Coding-GmbH/Skills/tree/main/skills/architecture-decision-record
Command: npx skills add https://github.com/PL-Coding-GmbH/Skills --skill architecture-decision-record-pl-coding-gmbh

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill aids in creating and documenting architectural decisions using the MADR (Markdown Any Decision Records) format, ensuring clear and accessible records for future reference.

Core Features & Use Cases

  • Create ADRs: Automatically generate Architectural Decision Records with the MADR template.
  • Capture Decisions: Record architectural decisions, their drivers, options, outcomes, and consequences.
  • Version Control: Maintain a history of decisions, allowing updates and superseding of previous versions when necessary.
  • Use Case: Use this Skill when you need to make a significant architectural decision that will shape your project, such as choosing a database or defining a new communication protocol.

Quick Start

Generate an ADR for a new architectural decision involving database choice by running the command 'create architecture decision record for database choice'.

Frequently Asked Questions about architecture-decision-record

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

FAQPage Schema
How do I document architectural decisions for long-term system design?▼

You document architectural decisions by creating Architectural Decision Records (ADRs) that capture decision details, drivers, considered options, and outcomes to maintain a clear system design history.

What is the MADR format for architecture decision records?▼

The MADR (Markdown Any Decision Records) format is a structured template for recording architectural decisions, ensuring options, outcomes, and consequences are clearly documented and accessible for future reference.

When do I need to create an architecture decision record?▼

You need to create an architecture decision record when making significant project decisions with long-term implications, such as choosing a database or defining a new communication protocol.

How do I update or supersede a previous architecture decision record?▼

You update or supersede previous architecture decision records by using the version control feature, which maintains a history of decisions and allows new versions to override older ones when necessary.

Can I maintain an index of architecture decision records for my project?▼

Yes, the Skill maintains an index of architecture decision records automatically, allowing you to track and reference the history of architectural decisions made throughout your project lifecycle.

Related Skills

Explore More Software Engineering Skills→
cpliakascpliakas
4

write-adr

Generate MADR-format Architecture Decision Records with sequential numbering and project context.

Community
Intermediate
fernandoartalffernandoartalf
20

bc-al-project-context

Manage AL development context with decision records and session handoffs.

Community
Intermediate
romiluz13romiluz13
161

architecture-patterns

Translate functionality requirements into architecture patterns with C4-inspired views.

Community
Intermediate
EngineerWithAIEngineerWithAI
4

architecture-decision-records

Create and manage Architecture Decision Records in multiple formats.

Official
Intermediate