adr

Creates Markdown decision records with YAML frontmatter documenting architectural choices, including scope, context, options, and consequences.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/nist0/CoDev --skill adr-nist0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/nist0/CoDev/tree/main/.github/skills/adr
Command: npx skills add https://github.com/nist0/CoDev --skill adr-nist0

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured approach to making and documenting architectural decisions, ensuring clarity, collaboration, and traceability.

Core Features & Use Cases

  • Structured Documentation: Offers a standardized format for Architecture Decision Records (ADR).
  • Decision Traceability: Enables tracking of why certain decisions were made, over time.
  • Stakeholder Collaboration: Encourages involvement of all relevant stakeholders in the decision-making process.
  • Use Case: For a team working on a large software project, this Skill helps document decisions around system architecture, ensuring that all team members are aligned and have access to the decision-making context.

Quick Start

Invoke the adr skill with 'adr create [decision-title] [stakeholders]' to initiate the creation of an ADR for a new decision.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document software architecture decisions for better traceability?

Architecture decision records provide structured documentation to track why specific architectural choices were made, ensuring clarity and traceability over time. This approach captures decision scope, context, options, and consequences in a standardized format.

What is the best way to structure architecture decision records for stakeholder collaboration?

Architecture decision records use YAML for frontmatter and Markdown for the body to structure architectural decisions. This standardized format captures decision scope, context, options, and consequences, encouraging involvement from all relevant stakeholders in the decision-making process.

How do I create an ADR to track architectural decisions in software projects?

To create an architecture decision record, invoke the skill with a decision title and stakeholder list. This initiates a structured template that documents the decision scope, context, available options, and resulting consequences for team alignment.

When do I need to use architecture decision records in my software project?

You need architecture decision records when working on large software projects that require structured decision-making and stakeholder collaboration. Documenting architectural decisions ensures all team members understand the context and remain aligned on system architecture choices.

What format do architecture decision records need for documenting system architecture?

Architecture decision records require YAML for frontmatter and Markdown for the body content. This format supports documenting decision scope, context, options, and consequences to ensure structured architectural decision-making and traceability.

Does documenting architectural decisions require any specific dependencies?

Documenting architectural decisions with this approach requires no external dependencies. It relies solely on standard YAML for frontmatter and Markdown for body text to generate structured records that capture scope, context, options, and consequences.