agentic-dev/docs/work/pre-commit-hooks-v1/_epic.md

id, prd, title, type, status, features, created

id	prd	title	type	status	features	created
pre-commit-hooks-v1	null	Pre-commit hooks v1 — husky + fast conformance gates on commit	epic	in-progress	tooling	2026-05-13

Goal

Install husky and wire pre-commit hooks that catch the cheap drift classes before code leaves the developer's machine. Slow checks stay in CI.

Why

Slip a manifest update without re-running pnpm work rebuild-state and the committed _state.json drifts from markdown reality. Forget to lint and a broken commit lands. Pre-commit hooks shrink the cycle from "wait for CI" to "wait one second".

Stories

• 01 — Install husky + lint-staged
• 02 — Pre-commit hook: lint-staged + state-sync
• 03 — State-sync guard script + tests