skills.rest
VictorHueni
VictorHueniCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-adr
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
lubusINlubusIN
48

frappe-project-triage

Identify Frappe project type, installed apps, version, and tooling.

Official
Intermediate
e2itse2its
1

factory-adr-management

Manage ADR, FDR, and Divergence Record lifecycles with constitution synchronization and CI gate enforcement.

Community
Advanced
NourcineAbNourcineAb

github-project-management

Automate GitHub issue tracking, board synchronization, and sprint planning workflows.

Community
Advanced
hgflimahgflima
1

documentation-and-adrs

Create and manage architectural decision records using markdown templates.

Community
Advanced