> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Git Hooks

> Pre-commit and pre-push hook enforcement for the Livepeer docs repository.

Canonical policy source:

* [`docs-guide/policies/infrastructure-principles.mdx`](../policies/infrastructure-principles.mdx)
* [`docs-guide/policies/quality-gates.mdx`](../policies/quality-gates.mdx)
* [`docs-guide/policies/root-allowlist-governance.mdx`](../policies/root-allowlist-governance.mdx)
* [`docs-guide/policies/agent-governance-framework.mdx`](../policies/agent-governance-framework.mdx)

This contributor page describes how to run hooks, not policy ownership details.

## Install / Verify

```bash theme={"theme":{"light":"github-light","dark":"dark-plus"}}
./.githooks/install.sh
lpd hooks status
```

## Enforcement Boundaries

### Pre-commit (`.githooks/pre-commit`)

* fast staged local/offline checks only
* structure/style/static checks + staged generator sync
* fail-fast when cheap blocking violations already exist
* reuses the expensive staged validation result when staged content and hook inputs are unchanged
* enforces pre-commit runtime budget (default `<= 60s`)

### Pre-push (`.githooks/pre-push`)

* codex governance checks on `codex/*`
* contract + issue readiness + lock/stash policy
* non-fast-forward guard on codex branches

### CI

* owns heavy and broad checks (browser/page/link/openapi sweeps)

## Overrides

If a human explicitly approves an override, follow:

* `ai-tools/ai-rules/HUMAN-OVERRIDE-POLICY.md`

Do not use bypass flags as a default workflow.