Adr

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.From its SKILL.md

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.

2 things 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.
runs commandsInstructs the agent to run 3 commands, including `node "${CLAUDE_PLUGIN_ROOT}/scripts/adr-index.mjs"` and 2 more.

What its file declares

Copied from the file, not written here

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, 351 tokens by cl100k_base, 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.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.