initiative/specs/006-pre-commit-gate/quickstart.md

Quickstart: Pre-Commit Gate

What This Feature Does

Adds a Git pre-commit hook (managed by Lefthook) that runs pnpm check before every commit. If any check fails, the commit is blocked.

Files to Create/Modify

File	Action	Purpose
lefthook.yml	Create	Lefthook configuration with pre-commit hook
package.json	Modify	Add lefthook devDependency + prepare script

Setup After Implementation

After the feature is implemented, hooks activate automatically:

pnpm install    # installs lefthook + runs `prepare` which calls `lefthook install`

How It Works

1. Developer runs git commit
2. Lefthook intercepts via the Git pre-commit hook
3. Lefthook runs pnpm check (format + lint + typecheck + test)
4. If pnpm check exits 0 → commit proceeds
5. If pnpm check exits non-zero → commit is blocked, output shown

Bypass

git commit --no-verify    # skips the pre-commit hook