PR GUARDRAILS

Three modes. One guardrail framework.

Heeler runs Block, Warn, and Observe guardrails on every pull request. Try new policies in Observe before enforcing them, route warnings to the right reviewers, and block the violations that should never merge — all from one config.

Three enforcement modes, one config.

Each guardrail picks a mode. Mix and match across your policy library — strict where it matters, observational where you're still learning the signal.

BLOCK

Stop the merge.

The PR cannot merge while the violation exists. Use Block for the things that should never land — known-malicious dependencies, critical CVEs in reachable code paths, valid secrets in committed files.

  • Hard merge block via required check
  • Bypass requires explicit approver + audit trail
  • Reasons and remediation steps surfaced in the PR comment
WARN

Flag for the reviewer.

The PR can merge, but the warning shows up in the PR with full context. Use Warn for risk that needs a human judgment call — medium-severity issues, deprecated APIs, dependency upgrades that pass tests but change behavior.

  • Inline PR comment with the violation explained
  • Routed to the right reviewer based on ownership
  • Tracked so warnings don't quietly accumulate
OBSERVE

Capture the signal silently.

No PR comment, no merge effect — just data. Use Observe to test a new guardrail against your real PR traffic before you roll it out. See what it would have blocked or warned on, tune thresholds, then promote.

  • Zero developer-facing noise during testing
  • Dashboard shows what would have triggered
  • Promote to Warn or Block with one config change

Roll out new policies without breaking PR flow.

The Observe → Warn → Block lifecycle lets you test, tune, and enforce — in that order — instead of guessing where the right threshold is and watching developers route around it.

STEP 01

Observe

Deploy the guardrail in silent mode. Watch what it would have caught against real PRs over a week or two.

STEP 02

Warn

Promote to Warn. Developers see the flag in their PRs; you learn how the signal lands in practice.

STEP 03

Block

Once the signal is clean and false positives are tuned out, promote to Block. The guardrail now prevents merges.

What you can guard on.

Heeler's guardrails draw from the same context engine the audit and remediation layers use. They're org-aware, not just rule-based.

Open-source dependencies

CVEs with reachability and exploitability context, malicious packages, license violations, compromised maintainers — evaluated against your runtime exposure, not just the manifest.

Code patterns

SAST findings with reachability analysis. AI-generated code that introduces auth bypasses, IAM regressions, or secrets handling antipatterns gets caught at PR time.

Secrets

Real, validated secrets in committed files — not placeholder regex hits. Heeler tells you whether the credential is actually live, not just whether it looks like one.

Agent Skills artifacts

PRs that introduce MCP configs, CLAUDE.md updates, or fetched documentation get scanned for prompt injection and suspicious instructions before they merge.

See your real PRs run through Heeler.

A demo on your codebase shows which guardrails would have caught what — and where Observe vs. Warn vs. Block lands for your team.