How does it prevent duplicate ADRs?

The skill performs a pre-creation check to verify existing titles and numbering, suggesting alternatives if a naming conflict or numbering gap is detected.

Does it update the main ADR directory automatically?

Yes, it automatically updates the docs/adr/README.md index file, keeping the status, dates, and numbering of all decisions synchronized.

Can it help me find related code for a decision?

Yes, it includes a reference collection phase that uses grep and repository tools to find related files, PRs, and issues to link in the ADR automatically.

Can I use custom templates with this skill?

Yes, it supports multiple templates including technology selection, architecture patterns, and general defaults, which can be further customized in your project assets.

What format does this skill use for ADRs?

It uses the Markdown Architectural Decision Record (MADR) format, which is a lean and structured template for capturing design decisions effectively.

Architecture Decision Record (ADR) Creator

Name: Architecture Decision Record (ADR) Creator
Author: thkt

bythkt

•

Learning & Documentation

Automates the creation and management of high-quality Architecture Decision Records (ADRs) using the MADR format.

This skill provides a structured six-phase workflow to document architectural decisions with consistency and rigor. It handles everything from pre-creation validation and template selection (technology, pattern, or general) to automated reference collection from codebases, PRs, and issues. By enforcing quality checklists and automatically updating index files, it ensures your project's architectural history remains traceable, searchable, and standardized, preventing duplicated efforts and maintaining a clear design rationale for the entire development team.

Key Features

01Built-in quality checklists and error recovery mechanisms

023 GitHub stars

03Context-aware template selection for technologies and patterns

04Automatic ADR index (README) updates and numbering

05Structured 6-phase MADR creation workflow

06Automated reference collection from code, PRs, and issues

Use Cases

01Maintaining a searchable history of design decisions for auditing and onboarding

02Recording major architectural pattern changes for team alignment

03Documenting technology stack selections and framework migrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thkt/claude-config creating-adrs

For use in Claude.ai and ChatGPT

Download Skill