joaoariedi

Hef.Adr — Development skill for Claude Code

Development community

Record an architecture decision as a report with machine-readable MADR status.

How to install Hef.Adr

Installs to ~/.claude/skills/joaoariedi-hefesto-hef.adr/SKILL.md

Terminal

mkdir -p ~/.claude/skills/joaoariedi-hefesto-hef.adr && curl -fsSL https://raw.githubusercontent.com/joaoariedi/hefesto/HEAD/commands/hef.adr.md -o ~/.claude/skills/joaoariedi-hefesto-hef.adr/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Hef.Adr does

model: sonnet description: "Record an architecture decision as a report with machine-readable MADR status" argument-hint: " [--status proposed|accepted|rejected]"

Decision record

Every file under `reports/` is a decision with evidence behind it, and every one carries MADR frontmatter so an agent can tell a live decision from a dead one without reading prose. A 98-record repository once had 59 of them misread because status was inferred from body text — retired mandates t

Alternatives in Development

ADR Rubber Duck — ADR（Architecture Decision Record）の壁打ち相手としてヒアリングを通じて意思決定を整理し、ADRドラフトを作成する 974 ★
StatsPAI — StatsPAI is the first Agent-native Python library for causal inference and applied econometrics — unified API 302 ★
Obsidian ADR — Generate a decision record when the vault structure changes — the vault knows why it knows what it does 277 ★