Back to browse
GitHub Repository

Shift from passive documentation to active enforcement.

58 starsTypeScript

Decision Guardian v1.2.0 – enforce architectural decisions at PR time

by iamalizaidi·Mar 15, 2026·2 points·0 comments

AI Analysis

●●SolidBig BrainSolve My Problem

Markdown ADRs automatically surface on PRs — prevents institutional amnesia at scale.

Strengths
  • Trie-based O(log n) lookup handles 3000+ file PRs without slowing CI.
  • No database or signup — two lines of YAML to get started.
  • v1.2.0 bug fixes came from real production usage feedback.
Weaknesses
  • ADR tools already exist — this is workflow enhancement, not category replacement.
  • Requires teams to actually write and maintain decision docs.
Target Audience

Engineering teams, tech leads, DevOps engineers

Similar To

ArchUnit · adr-tools · custom PR bots

Post Description

The tool is simple. You write your architectural decisions in a Markdown file what was decided, why, what was rejected. Decision Guardian maps those decisions to file glob patterns. When a PR touches a matched file, it posts a comment explaining the relevant decision.

No database. No signup. Two lines of GitHub Actions YAML.

v1.2.0 fixes several rule-engine bugs that surfaced from real usage:

Silent false-positives when content rules had no type field (every template shipped broken)

OR-only logic for multi-condition rules with no way to require ALL conditions

Deleted lines were invisible to all matchers — removing guarded code never triggered a warning

json_path rules failed silently for nested value edits because parent keys only appear as context lines in diffs

The fixes came directly from people running this on production repositories and reporting what wasn't working. That feedback loop has been more valuable than anything I designed upfront.

It also works as an npx CLI for pre-push checks outside GitHub Actions (GitLab CI, Jenkins, CircleCI, local hooks).

Repo: https://github.com/DecispherHQ/decision-guardian npm: npx decision-guardian check

Would love your feedback

Similar Projects