skills.rest
JansenAnalytics
JansenAnalyticsCOMMUNITY
Explore all skills by this author →
GitHub

adr-manager

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
One-click install
npx skills add https://github.com/JansenAnalytics/claudex --skill adr-manager-jansenanalytics
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
simonheimlichersimonheimlicher
1

architecting-python

Generate Architecture Decision Records for Python architecture decisions.

Community
Advanced
dgkngkdgkngk

architecture

Analyze requirements, evaluate trade-offs, and document architectural decisions with ADRs.

Community
Advanced
thincellerthinceller
4

write-adr

Creates ARC/ADR-style decision records documenting rationale, alternatives, statuses, and tradeoffs for technical choices in software projects.

Community
Intermediate
dt418dt418

Docs Pack

Build documentation platforms with versioned docs, search, navigation, code highlighting, and API reference generation.

Community
Intermediate