adr

Create, organize, and maintain Architecture Decision Records using a standard template.

114|13|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/jellydn/my-ai-tools --skill adr-jellydn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/jellydn/my-ai-tools/tree/main/skills/adr
Command: npx skills add https://github.com/jellydn/my-ai-tools --skill adr-jellydn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Decision Records (ADRs) capture and organize critical architectural decisions, ensuring context and rationale are preserved over time.

Core Features & Use Cases

  • Unified ADR management: create, update, and organize ADRs using a standard template.
  • Template-driven documentation: ADRs follow the ADR template stored at templates/adr-template.md.
  • Best-practice discovery: detect common ADR locations (doc/adr, docs/adr, architecture/decisions) to locate ADRs.

Quick Start

Initialize an ADR directory and create a new ADR with a descriptive title, then list or view ADRs as needed.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I create and organize architecture decision records for my software project?

Architecture decision records can be created and organized using a standard ADR template. The skill initializes an ADR directory, generates new records with descriptive titles, and manages the ADR lifecycle for your software project.

What is the best way to track architectural decisions and rationale over time?

Tracking architectural decisions involves capturing context and rationale using Architecture Decision Records. This approach preserves critical choices over time through template-driven documentation and supports supersession for updating past decisions.

Can I use existing ADR directories like docs/adr or architecture/decisions?

Existing ADR directories are fully supported. The skill automatically detects common locations such as doc/adr, docs/adr, and architecture/decisions to locate, list, and view your current architecture decision records.

How do I supersede an old architectural decision in project documentation?

Superseding an architectural decision is supported through the ADR lifecycle management. You can create a new decision record that marks the previous one as superseded, ensuring context and rationale are preserved over time.

Do I need a specific template format to document software architecture decisions?

A standard template is required for documenting software architecture decisions. The skill relies on a predefined ADR template located at templates/adr-template.md to ensure consistent structure across all project documentation.

How do I extract architectural decisions for onboarding and governance?

Extracting architectural decisions for onboarding and governance is handled by listing and viewing existing ADRs. The skill locates records in recognized directories to surface critical architectural choices and their rationale.