---
id: proof-convention-gate
title: Convention-Gate
slug: convention-gate
type: proof
status: draft
summary: A Git hook and MCP server that checks registered review prerequisites before a mediated commit.
agent_summary: Convention-Gate checks registered process state outside an agent prompt. Its scope is the valid enabled hook-mediated path; it does not authenticate review quality or cover bypassed paths.
artifact_stage: Public process-control mechanism
evidence_limit: Registered prerequisites are not proof that a review happened or covered the current changes.
audiences:
  - builders
  - security-leaders
  - hiring-managers
topics:
  - agent-controls
  - developer-tools
  - action-boundaries
claim_ids: []
proof_ids:
  - proof-convention-gate
source_ids:
  - source-convention-gate
visibility_queries: []
risk_level: medium
canonical_url: null
published_at: null
updated_at: 2026-11-10
proof_type: open-source
confidentiality: public-or-sanitized
---

# Convention-Gate

**Question:** which part of a process requirement can be checked at the action boundary rather than left inside a prompt?

[Inspect the public implementation](https://github.com/dvir-shamay/mcp-convention-gate)

## The mechanism

The tool pairs an MCP server with a Git pre-commit hook. The MCP tools record prerequisite state; under valid, enabled configuration, the installed hook checks the required PASS registrations before allowing a commit through that path.

The mechanism makes a narrow distinction: a model's instruction to follow a process is not the same thing as an external check of registered state.

## The important boundary

A PASS record is self-attestation. It does not authenticate the reviewer, prove a review occurred, establish its quality, or bind it to every line of the current change.

The hook also does not govern actions that bypass it. Disabled or invalid configuration, bypass flags, and unmediated paths matter. This is not a universal safety guarantee.

## Why show this work

The useful design question is what a control actually observes and governs. This artifact provides a concrete mechanism to inspect, alongside the limitations that keep its promise precise.

The project's study comparisons should not be treated as an isolated causal proof of enforcement or a universal result about instruction authority. This page makes only the bounded mechanism-level claim.
