Does the ADR Manager handle file numbering?

Yes. The skill automatically scans your existing ADR directory to find the highest current number and increments it for the next entry (e.g., moving from ADR-004 to ADR-005).

Can I link my ADRs to specific project builds?

Yes, the skill supports inclusion of context links to build artifacts, allowing you to link documentation directly to the state of the project when the decision was made.

What is an ADR and why should I use this skill?

An Architecture Decision Record (ADR) is a short text file that captures a significant architectural decision. This skill automates the creation of these records, ensuring your team remembers why specific technologies or patterns were chosen months or years later.

Should I use this for every code change?

No. The skill is designed for significant decisions like framework selection or pattern adoption. It includes guidance on skipping routine implementation details or minor code organization choices.

What template does this skill use?

It follows the Michael Nygard ADR template, which is the industry standard for documenting decisions including Title, Status, Context, Decision, and Consequences.

ADR Manager

Name: ADR Manager
Author: AlteredCraft

byAlteredCraft

•

学習とドキュメンテーション

Automates the creation and formatting of Architecture Decision Records (ADRs) to document significant technical choices using industry-standard templates.

The ADR Manager skill streamlines architectural documentation by managing Architecture Decision Record files within your project. It automatically determines sequential numbering, enforces the Michael Nygard template structure, and ensures that critical context, decisions, and consequences are captured during the development process. By integrating documentation directly into the coding workflow, it helps teams maintain a clear history of 'why' specific paths were chosen, reducing technical debt and making it easier for future maintainers to understand the evolution of the codebase.

主な機能

01Guidelines for identifying significant architectural decisions versus routine implementation

02Automated sequential numbering for new ADR entries

03Intelligent capture of context, status, decisions, and consequences

0410 GitHub stars

05Support for artifact build links for enhanced traceability

06Standardized Michael Nygard ADR template implementation

ユースケース

01Capturing deviations from original plans to provide historical context for future maintainers

02Recording the rationale for selecting a specific database or framework over alternatives

03Documenting structural trade-offs made during a major system refactor

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alteredcraft/claude-code-plugins adr-manager

For use in Claude.ai and ChatGPT

Download Skill