archradhq avatar

Deterministic

archradhq/arch-deterministic

Validates architecture-as-code graphs against deterministic lint rules and catches drift between your documented IR and actual codebase implementations. Ingests from OpenAPI specs or Backstage catalogs, merges IR fragments, runs structure and architecture validation (IR-STRUCT, IR-LINT codes), and reconstructs IR from live code in Node.js, Python, or C# to spot "dummy IR" scenarios where the design passes but the shipped code has direct database calls or undocumented routes. Runs offline in CI with reproducible exits, no LLM, no account. Reach for this when you need governance that fails the build on layering violations before merge, not post-mortem architecture review.

tools
6
transport
STDIO
last updated
Apr 29, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

archrad_validate_ir

No parameter schema in public metadata yet.

archrad_lint_summary

No parameter schema in public metadata yet.

archrad_validate_drift

No parameter schema in public metadata yet.

archrad_policy_packs_load

No parameter schema in public metadata yet.

archrad_list_rule_codes

No parameter schema in public metadata yet.

archrad_suggest_fix

No parameter schema in public metadata yet.

Sponsors

Readme

@archrad/deterministic

ArchRAD 0.7.2 running the zero-setup deterministic demo and scanning a repository into cited draft IR

Apache-2.0 no LLM no account

Your architecture drifts before you write a single line of code. archrad validate catches it — deterministically, in CI, before the PR merges.

Define your system as a graph. ArchRAD compiles it, lints it against architecture rules, and tells you exactly what's wrong — with rule codes, not opinions.

New in 0.7.x — archrad demo runs a full example with zero setup, and archrad scan drafts an IR from any repo with every node cited to file:line. Lint findings only decrease in this release; nothing that passed on 0.6.x can start failing. See the changelog.


Quick start (60 seconds)

npm install -g @archrad/deterministic
archrad demo

No IR file, no flags, no config — runs from any directory. Lints a bundled example and shows you the findings:


View the full README on GitHub

Details

Repository
github.com/archradhq/arch-deterministic
Package
@archrad/deterministic
Transport
STDIO
Registry
MCP registry, active