adr

Create Architecture Decision Records with sequential numbering and template metadata.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation and management of Architecture Decision Records (ADRs), ensuring consistency, automating tedious tasks, and reducing errors in documenting critical architectural choices.

Core Features & Use Cases

  • Automated ADR Creation: Generates new ADRs with sequential numbering and pre-filled metadata based on a template.
  • Index Management: Automatically updates the ADR index file (README.md) and a new checklist file (CHECKLIST.md).
  • ADR Listing & Viewing: Provides commands to list all ADRs with their status and display summaries of specific ADRs.
  • Validation: Includes an optional validation step to check ADR completeness before acceptance.
  • Use Case: When a new architectural decision needs to be documented, use this Skill to quickly create a new ADR, ensuring it follows the established format and is immediately discoverable.

Quick Start

Use the adr skill to create a new architecture decision record titled "Use Zustand Vanilla Stores".

Frequently Asked Questions about adr

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

FAQPage Schema
How do I standardize architecture decision records in my project?

You can standardize architecture decision records by using an automated workflow that generates sequentially numbered ADRs from a pre-filled template, ensuring consistent formatting and immediate discoverability across your project documentation.

How do I create a new architecture decision record automatically?

Create a new architecture decision record by triggering the generation workflow, which automatically assigns sequential numbering, applies a standardized template, and updates the ADR index and checklist files for your technical documentation.

What is the best way to manage and list existing ADRs?

The best way to manage existing ADRs is through automated listing commands that display all records alongside their current status, while simultaneously updating the index file and checklist to maintain an accurate overview of architectural choices.

Can I validate architecture decision records before accepting them?

Yes, you can validate architecture decision records before acceptance by running the optional validation step, which checks the ADR for completeness to ensure all critical architectural choices are fully and consistently documented.

When do I need to update the ADR index and checklist files?

You need to update the ADR index and checklist files whenever a new architecture decision record is created, a process that is fully automated to integrate the new entry into your project documentation without manual intervention.