Meilleures Pratiques — 10 Conseils

Pensez à Hermes Agent comme à un chef dans une cuisine très fréquentée. Vous ne laisseriez pas chaque cuisinier couper des légumes sur la même planche à découper tout en dressant les desserts — vous donneriez à chacun son propre poste de travail. La même logique s’applique à votre base de code.

---

1. Un Worktree par Expérience

Imaginez que vous peignez une maison. Vous ne peindriez pas le salon et la salle de bain en même temps avec le même pinceau — vous gâcheriez les deux. Les worktrees Git vous permettent de donner à chaque tâche Hermes sa propre “pièce” où travailler.

Au lieu de laisser Hermes modifier directement les fichiers dans votre dossier de projet principal, créez un espace de travail séparé pour chaque expérience. Cela protège votre code principal et garde vos modifications bien organisées.

2. Nommez les Branches d’après l’Expérience

Donnez à vos branches des noms clairs et descriptifs pour que vous (et votre futur vous) sachiez à quoi chacune sert :

git checkout -b feature/hermes-checkpoints-docs

Pas branch-1 ou test-fix. Soyez précis — vous vous remercierez plus tard.

3. Commitez Fréquemment

Pensez aux commits comme à la sauvegarde de votre progression dans un jeu vidéo. Vous ne voulez pas jouer pendant trois heures et tout perdre parce que vous n’avez pas sauvegardé.

Commitez à chaque étape importante :

git add .
git commit -m "Ajouter la documentation des checkpoints"

Pour les petites modifications guidées par les outils entre deux, utilisez les checkpoints de Hermes et /rollback comme filet de sécurité.

4. Évitez de Lancer depuis la Racine du Dépôt Nu

Lorsque vous utilisez des worktrees, ne lancez pas Hermes depuis le dossier du dépôt d’origine. À la place, faites cd dans le répertoire du worktree. Cela donne à chaque agent un périmètre clair et évite toute contamination croisée accidentelle.

5. Utilisez hermes -w pour les Worktrees Automatiques

Pas envie de configurer les worktrees manuellement ? Hermes a un raccourci intégré :

cd /chemin/vers/votre/depot
hermes -w

Cela crée automatiquement un worktree jetable avec sa propre branche. Vous pouvez même le combiner avec une requête unique :

hermes -w -z "Corriger le problème #123"

6. Lancez des Agents en Parallèle en Toute Sécurité

Vous voulez que plusieurs agents Hermes travaillent en même temps ? Ouvrez simplement plusieurs terminaux et lancez hermes -w dans chacun. Chaque session obtient automatiquement son propre worktree et sa propre branche isolés. Fini les agents qui se marchent sur les pieds.

7. Utilisez les Checkpoints + /rollback

Les erreurs arrivent. Ce n’est pas grave. Hermes vous permet de créer des checkpoints pendant une session et d’y revenir si quelque chose tourne mal. C’est comme avoir un bouton “annuler” pour les actions de votre agent.

8. Combinez Worktrees, Branches et Checkpoints

Voici la formule gagnante :

• Worktrees = des checkouts propres pour chaque session
• Branches = l’historique de haut niveau des expériences
• Checkpoints + /rollback = une récupération rapide après une erreur

Ensemble, ils vous offrent une itération rapide, une récupération facile et des pull requests propres.

9. Gérez le Développement UI Intelligemment

Si vous travaillez sur l’application TUI ou desktop sur plusieurs worktrees, vous aurez besoin de node_modules pour chacun. C’est beaucoup de fichiers dupliqués. Découvrez les helpers htui / hgui qui partagent une seule installation via un lien symbolique — cela économise de l’espace disque et du temps de configuration.

10. Gardez votre Branche Principale Propre

Tout l’intérêt de ces pratiques est de garder votre branche principale stable et prête pour la production. Ne fusionnez les branches de worktree que lorsqu’elles sont testées et complètes.

---

Résumé

Pensez aux worktrees comme à des bureaux séparés dans un open space. Chaque agent Hermes a son propre bureau avec ses propres outils, pour que personne ne gâche le travail des autres. Les branches sont votre système de classement, et les checkpoints sont vos post-it “j’étais là”.

Astuce pratique : Commencez simplement avec hermes -w pour votre prochaine tâche. C’est le moyen le plus simple d’obtenir l’isolation sans aucune configuration manuelle. Une fois à l’aise, ajoutez les checkpoints et le rollback à votre flux de travail. Vous vous demanderez comment vous avez pu travailler sans eux.