adr_management

Manage Architecture Decision Record lifecycles with hook-based enforcement.

1|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/hgflima/loopy --skill adr-management-hgflima
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr_management
Source: https://github.com/hgflima/loopy/tree/main/.claude/skills/adr_management
Command: npx skills add https://github.com/hgflima/loopy --skill adr-management-hgflima

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the creation, state transitions, auditing, and reindexing of Architecture Decision Records (ADRs) with deterministic enforcement via hooks.

Core Features & Use Cases

  • ADRs Lifecycle Management: Handle creation, status transitions, and audit of ADRs.
  • Enforceable Processes: Implement three layers of enforcement for ADRs (PreToolUse, PostToolUse, pre-commit).
  • Use Case: For software development teams, ensure that ADRs are correctly created, followed, and documented, leading to consistent and maintainable architectural decisions.

Quick Start

Initialize the hooks and configuration for ADR management by running the /adrs:setup command.

Frequently Asked Questions about adr_management

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

FAQPage Schema
How do I manage Architecture Decision Records lifecycle with enforceable processes?

Architecture Decision Records lifecycle management handles creation, status transitions, and audits using deterministic enforcement hooks. It ensures architectural decisions are consistently documented and followed by software development teams.

What is the best way to enforce ADR status transitions in software development?

The best way to enforce ADR status transitions is through three enforcement hook layers: PreToolUse, PostToolUse, and pre-commit. These deterministic processes ensure records are correctly created and updated.

How do I set up ADR management hooks for my project?

To set up ADR management, initialize the deterministic enforcement hooks and configuration by running the setup command. This configures the environment for creating, auditing, and reindexing records.

When do I need deterministic enforcement hooks for architecture decision records?

Deterministic enforcement hooks for architecture decision records are needed when software development teams require strict adherence to processes, ensuring decisions are correctly created, audited, and consistently documented.

Does ADR management support auditing and reindexing of existing records?

ADR management supports auditing and reindexing of existing records. It simplifies reviewing architecture decisions and maintaining an organized index throughout the software development lifecycle.

What are the limitations of using hooks for architecture decision record enforcement?

The metadata does not specify explicit limitations for hook-based architecture decision record enforcement, but it is designed for software development teams needing deterministic lifecycle management rather than informal documentation.