adr-init

Automates ADR scaffolding and documentation integration for projects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/natecostello/agent-skills --skill adr-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-init
Source: https://github.com/natecostello/agent-skills/tree/main/skills/adr-init
Command: npx skills add https://github.com/natecostello/agent-skills --skill adr-init

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the initialization of Architecture Decision Records (ADRs), helping teams quickly establish structured documentation for pivotal design choices.

Core Features & Use Cases

  • Project Scaffolding: Creates directory structures and templates for ADRs following MADR 4.0.
  • Guidance Integration: Adds ADR-related sections to existing project files like CLAUDE.md, README.md, CONTRIBUTING.md, and PR templates.
  • Use Case: When starting a new project or revising architecture, deploy this Skill to quickly set up consistent ADR documentation and guidance.

Quick Start

Run the skill to generate ADR scaffolding and integrate ADR documentation into your project.

Frequently Asked Questions about adr-init

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

FAQPage Schema
How do I set up architecture decision records for a new software project?

To set up architecture decision records, this Skill automates the generation of directory structures and MADR 4.0 templates. It scaffolds your ADR documentation and integrates architectural decision-making guidance directly into your existing project files.

What is MADR 4.0 and how does it structure architectural decision making?

MADR 4.0 is a standard format for architecture decision records that this Skill uses to document pivotal design choices. It provides structured templates for recording decisions, ensuring compliance and promoting best practices in architectural decision making across development teams.

Can I integrate architecture decision record guidance into my existing project documentation?

Yes, you can integrate architecture decision record guidance into existing project documentation. The Skill automatically adds ADR-related sections to project files like CLAUDE.md, README.md, CONTRIBUTING.md, and PR templates during scaffolding.

What is the best way to scaffold ADR directories across multiple repositories?

The best way to scaffold ADR directories across repositories is through automated initialization. This Skill generates consistent directory structures and MADR 4.0 templates, updating project documentation to ensure standardized architectural decision recording across your codebase.

Do I need any specific dependencies to initialize architecture decision records?

You do not need any specific dependencies to initialize architecture decision records. The Skill operates independently to generate directory structures, templates, and documentation updates without requiring external libraries or tools.

When should I not use automated scaffolding for architecture decision records?

You should not use automated scaffolding for architecture decision records if your project already maintains a custom or non-MADR 4.0 compliant documentation structure. The Skill standardizes directory layouts and templates, which may conflict with established bespoke documentation workflows.