Claude Cursor Skill

adr-workflow

Write, update or supersede an Architecture Decision Record (MADR). Load when a change picks one design among credible alternatives, sets a rule tooling or reviewers enforce, reverses an earlier ADR, or when asked to document a decision.

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download goldziher-ai-rulez-internal_builtins_universal_documentation_skills_adr-workflow-ca967ad.zip · 0 KB

goldziher/ai-rulez 162 16 forks MIT Updated 5h ago

Part of goldziher/ai-rulez — 151 skills

Install

skills CLI

npx skills add https://github.com/Goldziher/ai-rulez/tree/main/internal/builtins/universal/documentation/skills/adr-workflow

Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install goldziher-ai-rulez@llmmart

Git git clone https://github.com/Goldziher/ai-rulez.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole goldziher/ai-rulez collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

When to write one

A design picked among alternatives that others must live with, a rule that tooling enforces, or a reversal. Not for bug fixes, routine dependency bumps or a choice one PR fully explains.

Steps

Copy the template.
Fill the mandatory sections: Context and Problem Statement, Considered Options, Decision Outcome.
Name the file, command or PR behind each fact. Mark what you could not verify as "not verified".
Keep it to one decision.
Add the index row in the same PR.

Superseding

Check whether the ADR is on the default branch. If not, edit it in place. If it is, write a new ADR and change only the old one's status and date.

Statuses

proposed, accepted, rejected, deprecated, superseded by ADR-<area>/NNNN.

Optional extension

A "Measured impact" section for decisions with numbers: before, after, how measured, tool version.

Files (ai-rulez)

SKILL.md 1.1 KB

---
name: adr-workflow
description: "Write, update or supersede an Architecture Decision Record (MADR). Load when a change picks one design among credible alternatives, sets a rule tooling or reviewers enforce, reverses an earlier ADR, or when asked to document a decision."
---

## When to write one

A design picked among alternatives that others must live with, a rule that tooling enforces, or a reversal. Not for bug fixes, routine dependency bumps or a choice one PR fully explains.

## Steps

- Copy the template.
- Fill the mandatory sections: Context and Problem Statement, Considered Options, Decision Outcome.
- Name the file, command or PR behind each fact. Mark what you could not verify as "not verified".
- Keep it to one decision.
- Add the index row in the same PR.

## Superseding

Check whether the ADR is on the default branch. If not, edit it in place. If it is, write a new ADR and change only the old one's status and date.

## Statuses

`proposed`, `accepted`, `rejected`, `deprecated`, `superseded by ADR-<area>/NNNN`.

## Optional extension

A "Measured impact" section for decisions with numbers: before, after, how measured, tool version.