madr-decision-log

Load the canonical MADR decision-log workflow for ADR management.

3|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/ldilov/harness-forge --skill madr-decision-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: madr-decision-log
Source: https://github.com/ldilov/harness-forge/tree/main/.agents/skills/madr-decision-log
Command: npx skills add https://github.com/ldilov/harness-forge --skill madr-decision-log

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auto-discoverable wrapper for the canonical MADR decision-log workflow, enabling rapid adoption by agent runtimes without embedding full ADR logic.

Core Features & Use Cases

  • Auto-discovers the MADR decision-log workflow and loads the actual project-owned guidance from the canonical skill.
  • Serves as a lightweight entry point for agent runtimes to initiate ADR workflows (creation, review, normalization, validation, and supersession handling).
  • Use Case: On a software project, trigger ADR generation and maintenance by referencing the MADR workflow without embedding the full logic in the wrapper.

Quick Start

Load the canonical MADR decision-log skill from the library to enable ADR workflows.

Frequently Asked Questions about madr-decision-log

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

FAQPage Schema
What is a MADR decision-log and why use it for ADR management?

A MADR decision-log provides a structured markdown format for Architecture Decision Records (ADRs), enabling software teams to create, review, normalize, and validate technical decisions across repositories for consistent project documentation.

How do I automate ADR creation and maintenance across repositories?

Automate ADR creation and maintenance by loading the canonical MADR decision-log workflow, which enables agent runtimes to trigger markdown ADR generation, review, validation, and supersession handling without embedding full logic.

Does this MADR wrapper require any dependencies to manage markdown ADRs?

No, the MADR wrapper is a lightweight gateway with zero dependencies. It auto-discovers the canonical MADR decision-log workflow and loads project-owned guidance to enable ADR management in software projects.

Can I use this approach to supersede and normalize existing ADRs in my project?

Yes, you can supersede and normalize existing markdown ADRs by referencing the MADR decision-log workflow, which provides standardized scripts and references to validate and manage architectural decision records across repositories.

What is the best way to integrate ADR workflows into an agent runtime?

Integrate ADR workflows into an agent runtime by using this auto-discoverable wrapper, which acts as a lightweight entry point to load the canonical MADR skill and surface supporting scripts without embedding full ADR logic.