# Madr Decision Log

> auto-discoverable wrapper for `.hforge/library/skills/madr-decision-log/SKILL.md`.

- Skill: `ldilov/madr-decision-log-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ldilov/madr-decision-log-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ldilov/madr-decision-log-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ldilov (https://skillmd.com/u/ldilov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ldilov/madr-decision-log-2

---


# MADR Decision Log

## Activation

- trigger when a team needs to create, review, normalize, validate, or maintain markdown ADR files using MADR conventions
- trigger when `docs/decisions/`, ADR numbering, ADR-LOG generation, or supersession handling should become part of the repo workflow

## Use These Surfaces

- `.hforge/library/skills/madr-decision-log/SKILL.md`
- `.hforge/library/skills/madr-decision-log/references/`
- `.hforge/library/skills/madr-decision-log/scripts/`
- `.hforge/library/docs/authoring/enhanced-skill-import.md`
- `RESEARCH-SOURCES.md`
- `VALIDATION.md`

## Operating Rule

Use the canonical MADR skill under `.hforge/library/skills/` for the actual workflow. This wrapper exists so agent runtimes can discover the decision-log workflow quickly and then load the deeper project-owned guidance.