HN Showcase
Back to browse
GitHub Repository

Shift from passive documentation to active enforcement.

57 starsTypeScript

Decision Guardian now comes with CLI

by iamalizaidi·Mar 14, 2026·3 points·0 comments
Visit ProjectView on HN

AI Analysis

●●SolidSolve My ProblemShip It

Surfaces ADRs in PRs when protected files change, unlike static Log4brains.

Strengths
  • •Matches file changes to decision records automatically via glob and regex patterns.
  • •Posts contextual PR comments instead of blocking merges with hard build errors.
  • •CLI works across GitLab, Jenkins, and CircleCI, not just GitHub Actions.
Weaknesses
  • •Relies on teams actually maintaining the Markdown decision database consistently over time.
  • •Complex regex matching risks false positives without strict path constraints enabled.
Target Audience

Engineering leads, Senior developers

Similar To

Log4brains · adr-tools · CODEOWNERS

Post Description

Decision Guardian Prevent institutional amnesia by surfacing past architectural decisions directly

# Install globally

npm install -g decision-guardian

# Or use directly without installation

npx decision-guardian --help

# Check staged changes

decision-guardian check .decispher/decisions.md

# Check against a branch

decision-guardian check .decispher/decisions.md --branch main

# Auto-discover all decision files

decision-guardian checkall --fail-on-critical

# Initialize a new project with template

decision-guardian init --template security Use in any CI system — GitLab, Jenkins, CircleCI, pre-commit hooks, and more

Github Open Source -:

https://github.com/DecispherHQ/decision-guardian

Similar Projects