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