Prerequisites
- Release trigger — GitHub App connected; PRs labeled
verdikt:rcopen a cert window. - Signals — integrations auto-pull and/or your pipeline POSTs signals for that commit.
- Secrets in the repo:
VERDIKT_API_URL— e.g.https://api.useverdikt.comVERDIKT_API_KEY—vdk_live_…from Settings → Agent accessVERDIKT_WORKSPACE_ID— Settings → General
- Branch protection — require the
Verdikt gatecheck (or your job name) before merge.
Copy to .github/workflows/verdikt-gate.yml
Polls up to 12 × 10s (2 minutes) so signals can arrive before the job fails.
Agent-driven flows can use MCP
check_gate instead of polling — see MCP setup. GHA + branch protection still enforces merge at the button.Manual curl (debug)
gate.allowed is false.
Gate actions
action | Meaning |
|---|---|
merge | Certified — safe to merge |
collecting | Waiting for required signals |
self_heal | Threshold failure — fix and re-run |
escalate | Needs human override |