adr

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

1|Updated Jun 22, 2026

Search Tags:#project management #ADR #software documentation #architectural decision #code governance

Ready to run

npx skills add https://github.com/jchildree/The-QUESTION --skill adr-jchildree

💬 Prompt for ChatGPT / Claude Chat▼

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.