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.