ADR Guard MCP server

ADR Guard

Português (Brasil) · Documentation portal · Markdown documentation · Changelog

Understand architectural decisions. Record the reasoning. Keep the history trustworthy.

ADR Guard is a lightweight .NET command-line tool for creating, validating, reviewing, and indexing Architecture Decision Records (ADRs). It keeps decision documentation consistent in local development and CI without making architectural decisions for your team.

What is an ADR?

An ADR is a short document that explains one consequential software decision: the context that required it, the option selected, and the benefits and costs that follow. ADRs help future contributors understand why a system was shaped a certain way—not only what the code does.

New to the practice? Follow the progressive guide:

1. What is an ADR?
2. Why and when should a team use ADRs?
3. Write and validate your first ADR

What ADR Guard does

• creates offline Proposed ADRs from Minimal, Extended, or constrained Custom templates;
• validates canonical structure, filenames, statuses, required sections, links, IDs, and supersession relationships;
• supports separate, opt-in MADR 4.0 validation;
• generates a deterministic Markdown index only after validation succeeds;
• supports Git-aware incremental checks, diagnostic baselines, and JSON/SARIF reports;
• offers opt-in, advisory architecture impact analysis from explicit ADR-to-code mappings;
• verifies opt-in architectural drift and fitness evidence without evaluating MSBuild or treating missing evidence as compliance;
• offers opt-in, human-reviewed AI drafting and technical review with explicit providers and context;
• integrates with GitHub Actions, VS Code, versioned container images, and an optional independently packaged MCP server for compatible agents.

Validation confirms deterministic documentation rules. It does not approve technical merit, authorize a decision, or turn AI output into an accepted architecture.

Install

Install the published .NET Tool from NuGet.org:

dotnet tool install --global RodriOliveira.AdrGuard
adr-guard --version

Shortened. The full README is on GitHub.