Adr

Skill sp-daewoon/chronicle/skills/adr

📜 Never write changelogs or release notes by hand again — automate your entire docs lifecycle (ADR · changelog · release · devlog · index) with 6 zero-dependency Claude Code skills.

Install

npx -y skills add sp-daewoon/chronicle --skill adr

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Never lose the reasoning behind an architecture decision again. Use when recording or revisiting an Architecture Decision Record — creating a numbered ADR, transitioning its status (Proposed, Accepted, Deprecated, Superseded), or regenerating the index. Auto-numbers, fills the template, and rebuilds the index for you, adapting to any repo via config or auto-detection.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.7 KB, as published. Nobody here has run it

ADR Workflow

Record and manage Architecture Decision Records.

Resolve configuration first

Run the index helper in read mode to learn the ADR directory and current records:

node "${CLAUDE_PLUGIN_ROOT}/scripts/adr-index.mjs"

This prints the current index table (using chronicle.config.json if present, else auto-detected docs/adr / adr/). The next ADR number is max(existing) + 1.

Create a new ADR

Determine the next number from the index output above.
Read the template at ${CLAUDE_PLUGIN_ROOT}/templates/adr-template.md.
Fill {{NUMBER}}, {{TITLE}}, {{DATE}} (today, from the user/environment — never guess a random date).
Write to <adr.dir>/<NNNN>-<kebab-title>.md (zero-padded to numberWidth).
Regenerate the index:

node "${CLAUDE_PLUGIN_ROOT}/scripts/adr-index.mjs" --write

Transition status

Edit the ADR's frontmatter status: (and the ## Status section) to one of: Proposed, Accepted, Deprecated, Superseded, Rejected. When superseding, add Superseded by ADR-NNNN and link both directions. Then re-run adr-index.mjs --write.

Rules

Numbers only increase; never reuse or renumber.
One decision per ADR.
Write the ADR before or as the decision is made, not long after.
Always regenerate the index after any change.