docs: update git hooks documentation in README and install script

Author: Athemis

README.md

@@ -89,7 +89,23 @@ We welcome issues and PRs! See [CONTRIBUTING](CONTRIBUTING.md) for coding standa
 
 ### Git hooks
 
-Repository hooks live in `.githooks`. Run `./scripts/install-git-hooks.sh` once to point `core.hooksPath` there. Hooks enforce Conventional Commits and run `fmt` (writes changes), `clippy`, and `test` before each commit (set `SKIP_PRE_COMMIT=1` to bypass locally).
+Repository hooks live in `.githooks`. Run `./scripts/install-git-hooks.sh` once to point `core.hooksPath` there.
+
+The repository includes three git hooks:
+
+1. **`commit-msg`** — Validates commit messages follow [Conventional Commits](https://www.conventionalcommits.org/) specification at commit time
+2. **`pre-commit`** — Runs `cargo fmt` (writes changes), `cargo clippy`, and `cargo test` before each commit (set `SKIP_PRE_COMMIT=1` to bypass locally)
+3. **`pre-push`** — Validates all commits being pushed follow Conventional Commits, preventing malformed commits from reaching the remote (e.g., those that bypassed `commit-msg` during rebases)
+
+Both `commit-msg` and `pre-push` use shared validation logic from `validate-commit-msg.sh` to ensure consistent enforcement.
+
+Valid commit types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+Example commit messages:
+
+- `feat: add new feature`
+- `fix(ui): correct button alignment`
+- `docs: update README`
 
 ## FAQ
 

scripts/install-git-hooks.sh

@@ -1,7 +1,7 @@
+#!/usr/bin/env bash
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2025 Alexander Minges
 
-#!/usr/bin/env bash
 set -euo pipefail
 
 # Install repository-provided hooks by pointing git to .githooks.
@@ -12,4 +12,20 @@ ROOT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
 echo "Configuring git hooks path to .githooks"
 git config core.hooksPath "$ROOT_DIR/.githooks"
 
-echo "Done. Existing hooks were not overwritten; git now reads from .githooks/"
+echo ""
+echo "Git hooks installed successfully!"
+echo ""
+echo "The following hooks are now active:"
+echo "  • commit-msg  — Validates Conventional Commits format at commit time"
+echo "  • pre-commit  — Runs cargo fmt, clippy, and test before each commit"
+echo "  • pre-push    — Validates all commits before pushing to remote"
+echo ""
+echo "All hooks use shared validation logic from validate-commit-msg.sh"
+echo ""
+echo "Valid commit types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
+echo "Example: feat: add new feature"
+echo "         fix(ui): correct button alignment"
+echo ""
+echo "To bypass pre-commit hook locally: SKIP_PRE_COMMIT=1 git commit"
+echo "Note: commit-msg and pre-push hooks cannot be bypassed with --no-verify"
+echo "      to maintain commit message quality."