adr-manager

Record and retrieve Architecture Decision Records — log a decision's context, options, rationale, and tradeoffs, then list/search them.

Skill by JansenAnalytics

IndexedMIT★ 5

Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/jansenanalytics-adr-manager

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Record and retrieve Architecture Decision Records — log a decision's context, options, rationale, and tradeoffs, then list/search them. Use when making a non-trivial design or architecture decision, choosing between tools/approaches, or asked 'why did we do it this way?'

Use cases: design

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/adr-manager

What's inside

Skill name: adr-manager
Description: Record and retrieve Architecture Decision Records — log a decision's context, options, rationale, and tradeoffs, then list/search them. Use when making a non-trivial design or architecture decision, choosing between tools/approaches, or asked 'why did we do it this way?'
License: MIT
Instructions: 61 lines in SKILL.md · view on GitHub

Files (2)

INSTALL.md
SKILL.md

SKILL.md (first lines)

# ADR Manager Skill

Use when: making a non-trivial technical decision — choosing between options, committing to an architecture, or accepting a tradeoff. Record it so future sessions don't have to guess.

Trigger: any time you make a design decision, choose between tools/approaches, or the user asks "why did we do it this way?"

## Create an ADR

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs new \
  --project <project-name> \
  --title "Decision title" \
  --context "Why this decision was needed" \
  --options "option1,option2,option3" \
  --decision "chosen-option" \
  --rationale "Why this option was chosen" \
  --tradeoffs "What we gave up and why it's acceptable"
```

## List ADRs for a project

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs list --project <name>
```

## List all ADRs across all projects

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs list
```

## View an ADR

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs view ADR-001 --project <name>
```

## Search

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs search "query"
```

## Update status

```
node ${ADR_MANAGER_HOME:-$HOME/projects/adr-manager}/adr.cjs status ADR-001 Superseded --project <name>
```

## ADR files location

`~/projects/<project>/.adr/ADR-NNN-<slug>.md`

## When to create an ADR

- Choosing a database, language, or framework
- Deciding between build vs. buy
- Accepting a known tradeoff (e.g. no concurrency for simplicity)
- Any decision the user or future-Kite might question later

From JansenAnalytics/claudex, MIT.

Signals

Stars: 5
Forks: 0
Open issues: 0
Last commit (this folder): Jun 14, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License: MIT
Repository: github.com/JansenAnalytics/claudex
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from JansenAnalytics

Cite this page

adr-manager skill. Agent Mart. https://agentmart.dev/skills/jansenanalytics-adr-manager (last updated 2026-10-24)