adr-manager

Evaluate project changes and create or update Architectural Decision Records.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/wendeus0/AI-dotfiles --skill adr-manager-wendeus0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-manager
Source: https://github.com/wendeus0/AI-dotfiles/tree/main/core/skills/adr-manager
Command: npx skills add https://github.com/wendeus0/AI-dotfiles --skill adr-manager-wendeus0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps determine when a project change warrants creating or updating an ADR and drafts the ADR in the repository's standard format.

Core Features & Use Cases

  • Evaluate whether a change triggers an ADR.
  • Detect if the ADR already exists or covers the decision.
  • Decide to skip, update, or create a new ADR.
  • Write the ADR following the repository's ADR format, including context, decision, and consequences.

Quick Start

Assess a proposed change and run the ADR manager to determine if an ADR is needed, then draft or update the ADR accordingly.

Frequently Asked Questions about adr-manager

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

FAQPage Schema
When does a project change require an Architectural Decision Record?▼

The ADR manager evaluates proposed changes to detect if an existing Architectural Decision Record already covers the decision, then decides whether to skip, update, or create a new ADR for project governance.

How do I write an ADR following repository format standards?▼

To write an ADR, draft the document following the repository's standard format by including context, decision, and consequences sections to ensure proper engineering process documentation and project governance.

Do I need to create a new ADR if an existing one covers the decision?▼

You do not need to create a new ADR if an existing one covers the decision. The ADR manager detects existing documentation and determines whether to skip, update, or create a new record.

What is the best way to manage architectural decisions for project governance?▼

The best way to manage architectural decisions is to evaluate changes for durable impact, detect existing ADRs, and draft or update decision records in the repository format to maintain engineering process documentation.