Does it support standard ADR templates?

Yes, it detects your project's existing style and supports standard formats as well as MADR 4.0 enhancements for more detailed tracking.

An Architecture Decision Record (ADR) is a short document that captures a significant architectural decision, the context in which it was made, and its consequences.

Where does this skill save the ADR files?

The skill searches for common paths like docs/adr/, doc/adr/, or architecture/decisions/. If none exist, it defaults to creating a docs/adr/ directory.

Do I need to manually number new records?

No, the skill scans your existing files and automatically increments the numbering (e.g., ADR-0005) for any new decision you record.

How does it handle superseded decisions?

The skill automates the workflow by marking the old ADR as 'Superseded', linking to the new one, and updating the project index automatically.

Architecture Decision Manager

Name: Architecture Decision Manager
Author: joaquimscosta

byjoaquimscosta

•

Learning & Documentation

Automates the creation, numbering, and maintenance of Architecture Decision Records (ADRs) to document technical choices and trade-offs.

The Architecture Decision Manager skill streamlines the process of documenting significant technical decisions within your codebase. It automatically detects existing ADR directories, manages sequential numbering, and maintains a centralized index to ensure architectural history is searchable and consistent. By enforcing structured templates—including context, decision rationale, and consequences—it helps development teams track the 'why' behind their code, making it an essential tool for long-term project maintainability, team alignment, and onboarding.

Key Features

01Smart template detection to match existing project documentation styles.

023 GitHub stars

03Automatic sequential numbering and directory discovery for new decision records.

04Built-in supersession workflow to link deprecated decisions to their replacements.

05Support for MADR 4.0 enhancements including decision drivers and pros/cons analysis.

06Automated index maintenance to keep README tables and logs up-to-date.

Use Cases

01Recording architectural trade-offs during system design phases for future reference.

02Documenting the rationale for choosing specific frameworks, databases, or libraries.

03Managing a historical log of superseded technical decisions as a project evolves.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joaquimscosta/arkhe-claude-plugins managing-adrs

For use in Claude.ai and ChatGPT

Download Skill