Workflow Git & les gates de hook

Le repo est gardé par un hook PreToolUse sur Bash : .claude/hooks/git-guard.sh. Il rend certaines erreurs impossibles plutôt que de compter sur la discipline.

Ce qui est bloqué

1. git commit / git push sur main ou dev → refusé. Passe par une branche de feature + PR vers dev.
2. Nom de branche → doit matcher ^(feat|fix|chore|build|docs|refactor|test|perf)/[a-z0-9][a-z0-9-]*$. Ex. feat/profile-reviews.
3. gh pr create → refusé tant que .git/PAMBE_REVIEW_OK ne contient pas le SHA du HEAD courant.

Les sentinelles

Une sentinelle est un fichier sous .git/ contenant le SHA approuvé. Le hook compare ce SHA au HEAD : s'ils diffèrent (revue périmée) ou si le fichier manque, il bloque.

Sentinelle	Écrite par	Débloque
PAMBE_REVIEW_OK	agent pambe-conventions-reviewer	gh pr create (revue conventions)
PAMBE_DOCS_OK	skill /sync-docs (agent docs-sync)	gh pr create (doc à jour)

Sentinelle périmée

Chaque nouveau commit change le HEAD → les sentinelles deviennent périmées. Re-lance la revue (et /sync-docs si besoin) après ton dernier commit, juste avant gh pr create.

La mécanique complète du verrou de doc est décrite dans Docs-as-code.