adr-manager

Name: adr-manager
Availability: InStock
Author: JansenAnalytics

Create, list, view, and search per-project ADR files in Markdown format.

5|Updated Apr 8, 2026

Search Tags:#documentation #adr #rationale #project-management #architecture-decisions #tradeoffs #decision-records

Ready to run

npx skills add https://github.com/JansenAnalytics/claudex --skill adr-manager-jansenanalytics

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-manager
Source: https://github.com/JansenAnalytics/claudex/tree/main/skills/adr-manager
Command: npx skills add https://github.com/JansenAnalytics/claudex --skill adr-manager-jansenanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions accumulate and become hard to trace over time; this ADR Manager ensures decisions are recorded with context, options, rationale, and tradeoffs to preserve architectural knowledge.

Core Features & Use Cases

Create, list, view, and search ADRs per project to maintain a searchable decision log.
Store ADR entries in a consistent file structure under each project for auditability and onboarding.
Revisit past decisions to understand tradeoffs and rationale during refactoring or new feature work.

Quick Start

Create a new ADR for your project with a title, context, options, decision, rationale, and tradeoffs using the ADR manager.

Frequently Asked Questions about adr-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I document architecture decisions with context and tradeoffs?▼

To document architecture decisions, you record the context, options, rationale, and tradeoffs in a standard ADR format, creating a searchable log of project decisions for future reference and onboarding.

What is an ADR and why do I need to track architecture decisions?▼

An ADR is an architecture decision record that captures context, options, and rationale. Tracking ADRs prevents architectural knowledge from becoming hard to trace over time during refactoring or new feature work.

How do I create and search architecture decision records for a specific project?▼

You create and search ADRs per project using the ADR manager script, which stores entries at ~/projects/<project>/.adr/ADR-NNN-<slug>.md, supporting list, view, and search operations across the project lifecycle.

Can I use this ADR manager without installing any external dependencies?▼

Yes, you can use the ADR manager without external dependencies. It relies on a standalone internal script, adr.cjs, to perform create, list, view, and search operations while enforcing a standard ADR format.

What is the best way to maintain a searchable log of architectural rationale?▼

The best way to maintain architectural rationale is storing ADR entries in a consistent file structure under each project, ensuring auditability and enabling teams to revisit past tradeoffs during development.

What format does the ADR manager enforce for decision records?▼

The ADR manager enforces a standard ADR format requiring a title, context, options, decision, rationale, and tradeoffs, saving files as ADR-NNN-<slug>.md within the project's dedicated .adr directory.