[GH-ISSUE #689] Open-source GitHub Action that surfaces architectural decisions on PRs when protected files change. Github Action to enforce ADRs #4224

New Issue

GiteaMirror · 2026-05-01T21:19:14-05:00

GiteaMirror commented

2026-05-01 21:19:14 -05:00

Originally created by @decispher on GitHub (Feb 11, 2026).
Original GitHub issue: https://github.com/sdras/awesome-actions/issues/689

I built an action that solves a problem we kept running into — developers modifying critical code without knowing why it was implemented a certain way.

How it works:

You write decision records in markdown (what was decided, why, which files are affected)
When a PR touches those files, the action automatically posts a comment with the relevant context
Comments are idempotent (updates instead of spamming), supports glob patterns, regex content matching, and handles PRs with 3000+ files

What it's NOT:

Not a linter or code quality tool
No external network calls — runs entirely in your runner
No data leaves GitHub

MIT licensed, fully open source
It's basically CODEOWNERS but for "why" instead of "who."

Repo: Decision guardian

Originally created by @decispher on GitHub (Feb 11, 2026). Original GitHub issue: https://github.com/sdras/awesome-actions/issues/689 I built an action that solves a problem we kept running into — developers modifying critical code without knowing why it was implemented a certain way. **How it works:** - You write decision records in markdown (what was decided, why, which files are affected) - When a PR touches those files, the action automatically posts a comment with the relevant context - Comments are idempotent (updates instead of spamming), supports glob patterns, regex content matching, and handles PRs with 3000+ files **What it's NOT:** - Not a linter or code quality tool - No external network calls — runs entirely in your runner - No data leaves GitHub **MIT licensed, fully open source** It's basically CODEOWNERS but for "why" instead of "who." ## Repo: [Decision guardian](https://github.com/DecispherHQ/decision-guardian)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/awesome-actions#4224