Skip to content

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

@decispher

Description

@decispher

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions