Add adr-kit to the decision capturing tools list#104
Open
rvdbreemen wants to merge 1 commit into
Open
Conversation
adr-kit (https://github.com/rvdbreemen/adr-kit) is an MIT-licensed ADR toolkit aimed at AI coding agents: a Claude Code plugin plus dependency-free Python CLIs that also install into Cursor, GitHub Copilot, and OpenAI Codex CLI. Listed under Any template because it stores a Nygard-derived seven-section template and imports existing MADR and Nygard sets via guided migration. Beyond authoring it covers the maintenance side of the ADR lifecycle: enforcement of accepted decisions against diffs at commit/PR time, drift and staleness detection, relevance ranking for agent context, and an MCP server. Co-Authored-By: Claude Fable 5 <[email protected]>
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a new ADR tooling entry to the blog post’s “Any template” section, expanding the catalog of ADR tools and their capabilities.
Changes:
- Add a new bullet for
adr-kitincluding supported environments and features - Describe template/storage and migration support for
adr-kit
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Any template | ||
|
|
||
| - [ADG (Architectural Decision Guidance)](https://github.com/adr/ad-guidance-tool), a command-line tool written in Go for modeling, managing, and reusing architectural decisions in a lightweight and structured way (step-by-step usage example in this [Medium story](https://medium.com/olzzio/adg-a-light-architectural-decision-guidance-and-management-tool-902fd65d2185)). Template options: Nygard, MADR (basic), QOC. | ||
| - [adr-kit](https://github.com/rvdbreemen/adr-kit), an ADR toolkit for AI coding agents (Claude Code plugin plus dependency-free Python CLIs, also usable from Cursor, Copilot, and Codex CLI). Beyond authoring, it enforces accepted decisions against diffs at commit and PR time, detects decision drift and stale ADRs, ranks the ADRs relevant to a coding task, and ships a small MCP server. Stores a Nygard-derived seven-section template; imports MADR and Nygard sets via guided migration. |
| ### Any template | ||
|
|
||
| - [ADG (Architectural Decision Guidance)](https://github.com/adr/ad-guidance-tool), a command-line tool written in Go for modeling, managing, and reusing architectural decisions in a lightweight and structured way (step-by-step usage example in this [Medium story](https://medium.com/olzzio/adg-a-light-architectural-decision-guidance-and-management-tool-902fd65d2185)). Template options: Nygard, MADR (basic), QOC. | ||
| - [adr-kit](https://github.com/rvdbreemen/adr-kit), an ADR toolkit for AI coding agents (Claude Code plugin plus dependency-free Python CLIs, also usable from Cursor, Copilot, and Codex CLI). Beyond authoring, it enforces accepted decisions against diffs at commit and PR time, detects decision drift and stale ADRs, ranks the ADRs relevant to a coding task, and ships a small MCP server. Stores a Nygard-derived seven-section template; imports MADR and Nygard sets via guided migration. |
rvdbreemen
added a commit
to rvdbreemen/adr-kit
that referenced
this pull request
Jun 12, 2026
…ubmitted) Co-Authored-By: Claude Fable 5 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds adr-kit to the Any template section of the tooling page, alphabetically after ADG.
What it is: an MIT-licensed ADR toolkit aimed at AI coding agents. It ships as a Claude Code plugin plus dependency-free Python CLIs (stdlib only, Python 3.9+), and the same files install into Cursor, GitHub Copilot, and OpenAI Codex CLI.
Why the Any template section: it stores a Nygard-derived seven-section template and imports existing MADR and Nygard ADR sets via guided migration patterns, so projects on either format can adopt it without rewriting by hand.
What it adds beyond authoring (the lifecycle side most tools on the list leave manual):
Maintained, active (latest release v0.30.1, June 2026), MIT. I am the author.
🤖 Generated with Claude Code