Worktrees & hooks Git

Un worktree Git est un second dossier de travail rattaché au même dépôt. Il possède sa propre branche et ses propres fichiers extraits, tout en partageant l’historique Git avec le dossier principal. Vous pouvez donc garder une modification inachevée ouverte dans votre arbre habituel pendant qu’un autre travail avance ailleurs.

Ce n’est ni une copie complète du dépôt, ni une branche abstraite sans fichiers : les outils, tests et éditeurs peuvent l’ouvrir normalement.

Avec le réglage actif, chaque exécution d’agent reçoit son propre worktree sous .singularity-worktrees/<uuid>/ et une branche dédiée. L’agent lit, modifie, teste et commite dans ce dossier : il ne touche jamais les fichiers non commités de votre arbre de travail courant.

C’est la garantie centrale de Singularity pour le travail assisté par IA. Plusieurs agents peuvent avancer en parallèle sans que leurs fichiers se recouvrent.

1. Singularity crée le worktree depuis la branche de base du ticket.
2. L’agent travaille sur la branche dédiée, vérifie son travail et y crée ses commits.
3. À la fin, Singularity réapplique ces commits sur la dernière version de la branche de base.
4. Selon les réglages du board, le résultat est intégré automatiquement ou présenté dans l’onglet Revue.

L’intégration utilise un rebase, pas un merge. Les commits sont rejoués au sommet de la base pour conserver un historique linéaire, sans commit de fusion. Si la base a avancé et qu’un conflit apparaît, l’exécution reste disponible pour le résoudre.

Ouvrez Réglages → Git → Worktrees pour piloter l’isolation. Gardez Utiliser les worktrees Git activé pour le fonctionnement sûr décrit ici. La fusion automatique est distincte : désactivez-la si les exécutions terminées doivent attendre votre approbation dans l’onglet Revue.

Quand l’isolation est désactivée, l’agent écrit directement dans votre arbre de travail. Il n’existe ni dossier ni branche séparés : Singularity n’a donc rien à présenter comme travail isolé dans Revue.

Dans le navigateur, ouvrez la section des worktrees du projet puis le menu concerné. Supprimer le worktree efface son dossier, mais conserve sa branche et ses commits : son historique reste récupérable.

Nettoyer les worktrees supprime aussi leurs références de branche. Cette opération est irréversible. Vérifiez que tout travail utile a été intégré ou conservé ailleurs avant de confirmer.

Depuis le cockpit Git d’un projet, ouvrez l’onglet Hooks pour consulter les hooks détectés dans le dépôt. Ils exécutent les contrôles définis par le projet aux moments prévus par Git.

Si un hook pre-commit échoue, le commit n’a pas eu lieu. Corrigez la cause signalée — formatage, lint ou test, par exemple — puis relancez le commit. Les fichiers peuvent rester modifiés ou indexés : vérifiez leur état dans le cockpit Git.