# ADR Guard

Gives coding agents read-only tools to search, validate, and inspect architecture decision records. Helps maintain consistent ADR history and spot architectural drift.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 5
- Author: rodri-oliveira-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rodri-oliveira-dev/adr-guard/tree/HEAD/src/adrguard.mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/adr-guard

## What it does

The server gives compatible agents read-only access to Architecture Decision Records (ADRs). It verifies document sections, links, and status values against canonical rules. When indexing runs, it updates `docs/adr/README.md` only after all validation checks pass. Teams can choose between Minimal and Extended formats or opt into MADR 4.0 structures.

Beyond baseline verification, it inspects architectural drift and tracks code mappings. The system generates diagnostic output as text, JSON, or SARIF files. Running the package requires .NET 10.0. Validation enforces strict formatting rules, so it never evaluates the engineering merit of a design choice.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- validate formatting and status tags of architectural decision records
- detect architectural drift between source code and documentation
- generate a deterministic Markdown index for existing ADR files
- map recorded architectural decisions to code locations

## Example prompts
- Validate all files in the `docs/adr` folder using ADR Guard.
- Find architecture decisions that cover our database design.
- Regenerate the index file in `docs/adr/README.md` after recent changes.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [Sui Knowledge Base (kapa.ai)](https://affpapa.org/en/nevibecode/mcp/sui-knowledge-base-kapaai.md) — MCP server · ★ 7785
- [Claude Code Ultimate Guide](https://affpapa.org/en/nevibecode/mcp/claude-code-ultimate-guide.md) — MCP server · ★ 6258
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5585
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3451
- [Claude Code Explorer MCP](https://affpapa.org/en/nevibecode/mcp/codeaashu-claude-code-explorer-mcp.md) — MCP server · ★ 3412

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md