Git Hooks Reference

Local enforcement is managed by prek using prek.toml.

Install hooks with:

prek install
prek install --hook-type commit-msg

Hook Groups

• built-in hygiene: whitespace, EOF, large files, merge conflicts, JSON/TOML validation, private key detection
• formatting and linting: YAML, Ruff, shell, TOML, JSON, and workflow linting
• repository-specific checks:
  • pytest
  • changelog-check
  • docs-check-filenames
  • docs-check-links
  • docs-check-index
  • docs-check-frontmatter
  • mikado-branch-invariant-check

Why They Matter

• they keep docs and release inputs valid
• they surface secret and config mistakes before push
• they make quick interview-time edits safer

Follow-On Docs

• prek — install and config entrypoints
• automation-task-reference — task names behind the repo-specific hooks
• develop-locally — day-to-day local workflow
• agent-change-process — how hooks fit into C0/C1/C2 changes