arch-adr

Automate creation, review, and maintenance of Architecture Decision Records using MADR 4.x conventions.

Updated Apr 8, 2026

Search Tags:#project management #architecture #decision record #adr #madr

Ready to run

npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-adr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: arch-adr
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/arch-adr
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation, review, and management of Architecture Decision Records (ADRs), ensuring clarity, traceability, and adherence to best practices.

Core Features & Use Cases

ADR Lifecycle Management: Supports the full lifecycle of ADRs, including initialization, creation, supersession, updating, and review.
Auto-numbering: Automatically generates unique identifiers for new ADRs based on existing files.
Template Validation: Provides templates and checklists for quality assurance.
Use Case: Ideal for project teams to document and track architecture decisions, maintaining a comprehensive history for future reference.

Quick Start

To create a new ADR, execute: arch-adr create

Frequently Asked Questions about arch-adr

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

FAQPage Schema

How do I create Architecture Decision Records automatically?▼

You can create Architecture Decision Records automatically by running a command that initializes a new ADR, assigns it a unique auto-numbered identifier, and applies MADR 4.x template conventions for consistency.

What is the best way to manage the lifecycle of architecture decisions in a software project?▼

Managing the lifecycle of architecture decisions is best handled through automated initialization, version control, supersession, and review, ensuring decisions remain traceable and maintain historical consistency.

How does supersession work when updating architecture decision records?▼

Supersession for architecture decision records works by linking a new ADR to the outdated one, maintaining a clear version history that traces the evolution of architectural decisions over time.

Do I need MADR templates to document architecture decisions?▼

You need MADR 4.x templates to document architecture decisions if you want enforced structure and quality assurance, as this approach standardizes records for consistency across the project team.

Can I review architecture decision records for quality assurance automatically?▼

You can review architecture decision records using built-in validation checklists that enforce MADR 4.x conventions, ensuring each record meets structural quality standards before being finalized.

How do I initialize an ADR directory for a new software project?▼

To initialize an ADR directory for a new software project, execute the setup command which establishes the folder structure and applies the necessary templates for tracking architectural decisions.