adr

Generate ADR files in wiki/adrs/ with context, decision, and consequences.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/ImLp/claude-caide --skill adr-imlp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/ImLp/claude-caide/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/ImLp/claude-caide --skill adr-imlp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decisions shape the long-term health of a codebase, but are often poorly documented or scattered across ad-hoc notes. This skill provides an interactive workflow to create, update, and reference Architectural Decision Records (ADRs) stored in wiki/adrs/, preserving reasoning, context, and consequences for future developers.

Core Features & Use Cases

  • ADR creation: Generate new ADRs with context, decision, and consequences, automatically linking to related wiki modules.
  • Status tracking: Update ADR status (proposed, accepted, superseded, deprecated) and cross-reference with related decisions.
  • Guided interviewing: Interactive prompts collect essential fields (Context, Decision, Consequences, Files to modify) and ensure consistency across ADRs.
  • Use Case: When planning a major refactor, create an ADR to document rationale and expected impact before changes occur.

Quick Start

Trigger the adr workflow with /adr [title] to begin a new ADR in wiki/adrs/ and respond to prompts to capture context, decision, consequences, and files to modify.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document architectural decisions in my codebase?

You document architectural decisions by interactively generating ADR files in wiki/adrs/ with context, decision, and consequences. This skill guides you through prompts to capture essential fields and ensures ADR status tracking for future reference.

What is the best way to track architectural decision status during a refactor?

Tracking architectural decision status during a refactor involves updating ADR states like proposed, accepted, superseded, or deprecated. This skill enables status tracking and cross-referencing with related wiki modules to maintain consistency across decisions.

How do I create an ADR for a codebase change planning scenario?

To create an ADR for codebase change planning, trigger the workflow with /adr [title] and respond to interactive prompts. You will capture context, decision, consequences, and files to modify to document rationale and expected impact before changes occur.

Can I cross-reference architectural decision records with existing wiki modules?

Yes, you can cross-reference architectural decision records with wiki modules. When generating ADRs in wiki/adrs/, the skill automatically links to related wiki modules and allows cross-referencing with related decisions for comprehensive codebase governance.

What context do I need to prepare before generating an ADR file?

Before generating an ADR file, prepare the architectural context, the decision rationale, expected consequences, and a list of files to modify. The interactive interviewing process will prompt you to supply these essential fields to ensure consistency across records.

When should I use an interactive ADR workflow instead of ad-hoc documentation?

Use an interactive ADR workflow instead of ad-hoc documentation when planning major refactors, codebase change scenarios, or deprecations. It preserves reasoning, context, and consequences in structured wiki/adrs/ files rather than scattering notes across disparate locations.