Ross ROSS = Recommend OSS · open-source software intelligence for agents

npryce/adr-tools

Command-line tools for working with Architecture Decision Records observed · 2026-08-28

github.com/npryce/adr-tools · Shell · NOASSERTION (other) observed · 2026-08-28

Health v2 · maintenance only

23/100

  • Activity 0
  • Release rhythm 8
  • Longevity 100

Flags: no_license

How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.

  • gap_med: n/a
  • age_days: 3863
  • days_rel: n/a
  • days_push: 860
  • n_releases_24m: 0

Full methodology

Adoption not part of the score

5628 stars · 633 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A command-line tool for creating and managing a log of Architecture Decision Records (ADRs) stored as numbered Markdown files in a project repository. It automates ADR creation, numbering, and superseding links between decisions.

Use cases

  • record architecture decisions as markdown files in my repo
  • create numbered ADRs from the command line
  • mark an old decision as superseded by a new one
  • initialize an ADR log directory for a project
  • manage architecture decision records without a wiki

When to choose

  • you want lightweight, git-friendly ADRs as plain Markdown
  • you prefer a simple CLI workflow with editor integration
  • you need automatic numbering and supersede linking between decisions

When to avoid

  • you need a web UI or collaborative ADR review workflow
  • you want rich templating or integrations beyond basic Markdown files
  • you need a tool under an unambiguous permissive license

Facets

cli-tool · maturity maintenance

cli documentation markdown developer-tools documentation cli windows architecture-decision-records adr shell technical-documentation command-line linux macos

1 source

Member repositories

RepositoryRoleHealth v2
npryce/adr-toolsmain23

For agents

markdown · JSON · MCP: product_card(name="npryce/adr-tools")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem