Adr

Skill byerlikaya/claude-starter-kit/plugin/skills/adr

Architecture Decision Record: context-decision-consequences, for decisions that are expensive to reverse. Written under docs/adr/. Trigger phrases: "adr", "architecture decision", "decision record", "why this approach"From its SKILL.md

Install

npx -y skills add byerlikaya/claude-starter-kit --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

22 stars22 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.

SKILL.md

1.1 KB, 204 tokens by cl100k_base, as published. Nobody here has run it

Architecture Decision Record (ADR)

When

On an architecture/technology choice that is expensive to reverse, long-lived, or contested (database selection, auth strategy, critical pattern). Small/reversible decisions do not require an ADR.

Format (docs/adr/NNNN-short-title.md, ~1 page)

# NNNN. <Decision title>
Status: proposed | accepted | rejected | superseded (by NNNN)
## Context
Which problem/constraint requires this decision?
## Decision
What was decided (clear, one sentence + rationale)?
## Consequences
Pros / cons / accepted trade-offs.
## Alternatives considered
Why were they not chosen?

Principles

Invariant: a new decision marks the old ADR as superseded; an ADR is never deleted (decision history is preserved).
Numbered and dated; keep it short.

DoD

Decision + rationale + rejected alternatives recorded; status current.

What ships with it

Read from the repository

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