Aller au contenu

🌿 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 à .agents/rules/git-workflow.md :

<type>/<objectif-court>
TypeQuand l’utiliser
featNouveau contenu (chapitre, entrée lexique, nouvelle section)
fixCorrections (liens cassés, faits erronés, typos)
choreMaintenance, refresh, backlog, fichiers agent
docsMé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.

Voir aussi

Donner mon avis

Tout est facultatif : une seule réponse suffit. Ce site n'envoie rien : c'est vous qui envoyez, par le moyen de votre choix.

Votre notePas de note
Votre avis porte sur
Sur quoi ? (plusieurs choix possibles)
Ce qui sera envoyé
Envoyer par e-mail

Privé, sans compte : ouvre votre messagerie avec le message prêt, pour ia-on-prem@damien.becherini.fr.

Ouvrir un ticket GitHub ↗

Public, avec un compte GitHub. Vous relisez le ticket avant de le publier.

Pour le coller où vous voulez.

Donnez au moins une note, un sujet ou un message pour pouvoir envoyer.