adr

Generate ADR documents with context, alternatives, and trade-offs.

1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/im9/inboil --skill adr-im9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/im9/inboil/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/im9/inboil --skill adr-im9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often scattered in meetings and PRs. This skill provides a structured, reproducible way to capture rationale, alternatives, and consequences as formal ADR documents.

Core Features & Use Cases

  • Structured ADR templates: Generates ADR documents in docs/ai/adr/{NNN}-{slug}.md with sections for Context, Decision, and Consequences.
  • Numbering & traceability: auto-increments ADR numbers by scanning existing docs/ai/adr entries, ensuring unique IDs.
  • Research & justification: Guides researchers to collect context, forces consideration of trade-offs, and records decisions for future reference.
  • Future extensions: Supports ASCII diagrams and linkable references to related code/docs.

Quick Start

Create a new ADR document for the proposed feature and save it under docs/ai/adr as ADR {NNN}-{slug}.md.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document software architecture decisions in a structured format?▼

Document architecture decisions using an ADR template to capture context, alternatives, and consequences. This generates a standardized markdown file with sections for problem identification, design proposals, and trade-offs.

What is the best way to track and number architecture decision records in a project?▼

Track architecture decision records by auto-incrementing their numbers through scanning existing project files. This ensures unique IDs and traceability by generating files using a sequential numbering and slug naming convention.

How do I create an ADR document that includes context and trade-offs?▼

Create an ADR document by applying the ADR process to identify the problem, propose a design decision, and record context, alternatives, and consequences. The output is a markdown file with standard ADR sections.

Can I include diagrams and links to code in architecture decision records?▼

Yes, architecture decision records support future extensions including ASCII diagrams and linkable references to related code or documentation, enhancing the context and traceability of your design decisions.

Why should I use ADRs instead of scattering architecture decisions in PRs and meetings?▼

ADRs provide a structured, reproducible way to capture decision rationale, alternatives, and consequences as formal documents, preventing the loss of context that happens when decisions are scattered across meetings and pull requests.