Ta première contribution

Le repo est gardé par des hooks : certaines actions Git sont bloquées tant que les conventions ne sont pas respectées. Ce n'est pas une punition — c'est ce qui garde l'historique propre quand des dizaines de PR sont ouvertes par des agents.

Le parcours type

Les règles imposées par le hook

.claude/hooks/git-guard.sh (un PreToolUse sur Bash) bloque :

1. git commit / git push sur main ou dev. Toujours passer par une branche de feature et une PR vers dev.
2. Les noms de branche hors convention. Format imposé : <type>/<kebab-desc> où type ∈ {feat, fix, chore, build, docs, refactor, test, perf}. Exemple : feat/profile-reviews.
3. gh pr create tant que .git/PAMBE_REVIEW_OK ne contient pas le SHA du HEAD courant. Ce fichier est écrit par l'agent pambe-conventions-reviewer une fois la revue passée.

Le double verrou de la doc

Depuis l'app docs, un second verrou s'ajoute : si ta PR touche un fichier listé dans le front-matter sources: d'une page de doc, gh pr create est aussi bloqué tant que la doc n'a pas été rafraîchie. Lance /sync-docs pour lever le verrou. Tout est expliqué dans Docs-as-code.

Checklist avant d'ouvrir la PR

• Branche au bon format (feat/..., fix/..., …).
• pnpm typecheck passe.
• pnpm lint ne remonte rien de neuf (la plupart des règles sont en warning, pas en error).
• Conventions respectées (object-args, getEnv(), i18n, ports packages/lib) — voir Conventions.
• Si du code documenté a changé : /sync-docs exécuté.
• pambe-conventions-reviewer lancé et passé.