🌿 Branches, PRs & Notifications

Git est le garde-fou naturel d’un agent custodien. Il transforme une action risquée (“l’agent modifie le vault”) en proposition réversible (“l’agent ouvre une branche avec un diff”).

Convention de branche

Format recommandé — conforme à .cursor/rules/git-workflow.mdc :

<type>/<objectif-court>

Type	Quand l’utiliser
`feat`	Nouveau contenu (chapitre, entrée lexique, nouvelle section)
`fix`	Corrections (liens cassés, faits erronés, typos)
`chore`	Maintenance, refresh, backlog, fichiers agent
`docs`	Méta uniquement (rules, skills, plans)

Exemples :

feat/owasp-2025-alignment
chore/vault-refresh-2026-06
fix/broken-links-audit
chore/lexique-backlog-cleanup

Contenu minimal d’une PR agent

Une PR générée par agent doit contenir :

résumé lisible ;
fichiers modifiés ;
sources externes consultées ;
commandes exécutées ;
limites et hypothèses ;
checklist de revue humaine.

Notifications

Canaux possibles :

GitHub PR ;
email ;
webhook Slack/Matrix/Discord ;
fichier de log via vault-log-run sous .agents/vault-maintenance/runs/ (trace principale pour les runners non-interactifs ou les tâches sans PR).

Le canal importe moins que la règle : la notification ne vaut pas validation.

Anti-patterns

branche unique agent-work réutilisée indéfiniment ;
commit direct sur main ;
PR sans sources ;
notification qui déclenche automatiquement le merge ;
agent qui relance une tâche superseded parce qu’un vieux plan contient encore des TODOs.