What templates are supported by this skill?

The skill supports four variants: Nygard (balanced), Lightweight (minimal), Full (comprehensive), and MADR (Markdown standard).

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made along with its context and consequences.

Does it require manual context entry?

While you provide the title, the skill uses an Explore agent to search your codebase for relevant files and patterns to automatically populate the context section.

How does it handle ADR numbering?

It automatically scans your docs/adr/ directory, finds the highest existing number, and increments it by one, using a 4-digit padded format like 0023.

Where are the files saved?

ADRs are saved as Markdown files in the docs/adr/ directory of your current project repository.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: mgiovani

bymgiovani

•

Learning & Documentation

Automates the creation of numbered Architecture Decision Records (ADRs) to document technical choices and codebase evolution.

This skill streamlines the architectural documentation process by generating standardized ADR files directly within your repository. It automatically handles 4-digit ID incrementing, title sanitization, and intelligent context gathering from your existing codebase to ensure records are grounded in reality. By supporting multiple industry-standard formats like Nygard, MADR, and Lightweight templates, it helps development teams maintain a searchable history of why specific technologies or patterns were chosen, facilitating better long-term maintenance and team alignment.

Key Features

01Smart context gathering to reference real files and existing code patterns

02Four professional template variants: Nygard, Lightweight, Full, and MADR

032 GitHub stars

04Anti-hallucination verification to ensure documented technologies actually exist in-project

05Automated 4-digit ID incrementing and kebab-case file naming

06Built-in ADR lifecycle management from Proposed to Superseded status

Use Cases

01Recording the rationale behind choosing specific API authentication patterns

02Establishing a standardized documentation workflow for new architectural proposals

03Documenting a shift to a new database technology or migration strategy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mgiovani/cc-arsenal docs-adr

For use in Claude.ai and ChatGPT

Download Skill