From madr-manager
Skill for creating, listing, and managing MADR (Markdown Architectural Decision Records) following the Structured MADR v4.0.0 format. Handles creating new ADR files, reviewing and updating the status of existing ADRs, listing all ADRs, and summarizing the decision history for a specific topic. Triggered by instructions such as "write an ADR", "record an architectural decision", "add a MADR", or "summarize ADR history".
How this skill is triggered — by the user, by Claude, or both
Slash command
/madr-manager:managing-madrThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Write all ADR content in the same language the user is conversing in.
references/spec/adr-template.mdreferences/spec/index-template.mdreferences/spec/structured-madr-spec.mdreferences/workflow/create-adr.mdreferences/workflow/generate-index.mdreferences/workflow/list-adrs.mdreferences/workflow/show-adr.mdreferences/workflow/summarize-adr-history.mdreferences/workflow/update-adr-status.mdWrite all ADR content in the same language the user is conversing in.
For example, If the conversation is in Japanese, write the ADR in Japanese, and if the conversation is in English, write the ADR in English.
Use the OS temporary directory when intermediate file storage is needed (e.g., staging content before writing, processing large structures). This is optional — only use when the workflow genuinely benefits from it.
Session directory:
mktemp -d -t madr-session-XXXXXXCleanup:
rm -rf <session-dir>$TMPDIR/madr-session-* or /tmp/madr-session-* are safe to ignore.Never read the same file twice. Before loading any reference file, check which files have already been read in this conversation and skip if already loaded.
| Category | Pre-loading | Rule |
|---|---|---|
references/workflow/ | Prohibited | Load immediately before executing the corresponding operation |
references/spec/ | Allowed | Load when needed (pre-loading is acceptable) |
Identify which operation the user is requesting, then read the corresponding reference file and follow its instructions.
Trigger: User asks to create / add / write an ADR, or to record an architectural decision.
→ Read references/workflow/create-adr.md and follow the workflow defined there.
Trigger: User asks to list, show, or view existing ADRs.
→ Read references/workflow/list-adrs.md and follow the workflow defined there.
Trigger: User asks to update, change status, deprecate, supersede, or reject an existing ADR.
→ Read references/workflow/update-adr-status.md and follow the workflow defined there.
Trigger: User asks to show, read, or view a specific ADR.
→ Read references/workflow/show-adr.md and follow the workflow defined there.
Trigger: Any of the following:
→ Read references/workflow/summarize-adr-history.md and follow the workflow defined there.
Trigger: User explicitly asks to generate, create, or initialize index.md. Also invoked from other workflows when index.md is required but does not exist.
→ Read references/workflow/generate-index.md and follow the workflow defined there.
| File | When to read |
|---|---|
references/workflow/create-adr.md | When creating a new ADR |
references/workflow/list-adrs.md | When listing existing ADRs |
references/workflow/update-adr-status.md | When updating ADR status |
references/workflow/show-adr.md | When showing a specific ADR |
references/workflow/summarize-adr-history.md | When summarizing decision history for a topic |
references/workflow/generate-index.md | When generating or initializing index.md |
references/spec/adr-template.md | When writing an ADR file (referenced from create-adr.md) |
references/spec/index-template.md | When generating index.md (referenced from create-adr.md and generate-index.md) |
references/spec/structured-madr-spec.md | When you need authoritative MADR format details |
npx claudepluginhub zv-louis/zv-plugin-marketplace --plugin madr-managerWrites Architectural Decision Records (ADRs) using the MADR template and verifies completeness with Definition of Done (E.C.A.D.R.) criteria. Use when documenting architectural decisions from meetings or PR discussions.
Generates Architectural Decision Records (ADRs) in MADR, Nygard, Alexandrian, or project formats. Researches directory for conventions, gathers context, numbers sequentially, validates, and saves. Use for documenting technical decisions.