adr

Create, review, and audit Architectural Decision Records in an Obsidian vault.

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/jchildree/The-QUESTION --skill adr-jchildree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/jchildree/The-QUESTION/tree/main/.agents/skills/adr
Command: npx skills add https://github.com/jchildree/The-QUESTION --skill adr-jchildree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage and document Architectural Decision Records (ADRs) for software projects, streamlining the process of creating, reviewing, and auditing ADRs.

Core Features & Use Cases

  • ADR Creation and Review: Guided creation of ADRs and review for completeness.
  • Project Binding: Automatically binds to the active project's ADR directory.
  • Audit and Reporting: Audits all ADRs and generates INDEX.md and SUMMARY.HTML.

Quick Start

Run /adr create to start creating a new ADR.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I create and document architectural decision records for a software project?

You create architectural decision records using guided templates that capture context, decision, and status. This Skill manages ADR creation by binding to your active project directory, then generates a compliant markdown record for code governance.

Do I need an Obsidian vault to manage architectural decision records?

Yes, you need an Obsidian vault to manage architectural decision records. The Skill requires this shared memory environment for project binding, ensuring all ADRs are synchronized with your project directory and accessible locally.

Can I generate a summary report or index of all architectural decision records?

Yes, you can generate a summary report of all architectural decision records. The Skill audits your ADR directory and automatically generates an INDEX.md and SUMMARY.HTML file for quick review and compliance reporting.

What is the best way to review architectural decision records for completeness?

The best way to review architectural decision records for completeness is using a dedicated audit protocol. This Skill reviews newly created ADRs against project-specific formats and metadata requirements to ensure full compliance.

How does project binding work when managing software documentation for ADRs?

Project binding works by automatically connecting the ADR management process to your active project's specific directory. This ensures all software documentation and architectural decisions are stored in the correct location within your Obsidian vault.