Best Practices — 10 Consigli

Pensa a Hermes Agent come a uno chef in una cucina affollata. Non lasceresti che ogni cuoco tagli le verdure sullo stesso tagliere mentre impiatta anche i dessert — daresti a ciascuno la propria postazione. La stessa logica vale per il tuo codebase.

---

1. Un Worktree per Ogni Esperimento

Immagina di dover verniciare una casa. Non dipingeresti il soggiorno e il bagno allo stesso tempo con lo stesso pennello — combineresti un pasticcio. I worktree di Git ti permettono di dare a ogni task di Hermes la sua “stanza” in cui lavorare.

Invece di lasciare che Hermes modifichi i file direttamente nella cartella principale del tuo progetto, crea uno spazio di lavoro separato per ogni esperimento. Questo mantiene il tuo codice principale al sicuro e le tue modifiche in ordine.

2. Dai Nomi ai Branch Basandoti sull’Esperimento

Dai ai tuoi branch nomi chiari e descrittivi, così tu (e il te del futuro) saprete a cosa serve ciascuno:

git checkout -b feature/hermes-checkpoints-docs

Non branch-1 o test-fix. Sii specifico — ti ringrazierai più tardi.

3. Fai Commit Frequenti

Pensa ai commit come al salvataggio dei progressi in un videogioco. Non vorresti giocare per tre ore e poi perdere tutto perché non hai salvato.

Fai commit nei momenti chiave:

git add .
git commit -m "Add checkpoint documentation"

Per modifiche più piccole e guidate dagli strumenti nel mezzo, usa i checkpoint di Hermes e /rollback come rete di sicurezza.

4. Evita di Lavorare dalla Radice del Repo Principale

Quando usi i worktree, non eseguire Hermes dalla cartella originale del repo. Invece, fai cd nella directory del worktree. Questo dà a ogni agente un ambito chiaro e previene contaminazioni incrociate accidentali.

5. Usa hermes -w per i Worktree Automatici

Non vuoi impostare i worktree manualmente? Hermes ha una scorciatoia integrata:

cd /path/to/your/repo
hermes -w

Questo crea automaticamente un worktree usa-e-getta con il suo branch. Puoi anche combinarlo con una singola richiesta:

hermes -w -z "Fix issue #123"

6. Esegui Agenti in Parallelo in Modo Sicuro

Vuoi che più agenti Hermes lavorino contemporaneamente? Apri semplicemente diversi terminali ed esegui hermes -w in ciascuno. Ogni sessione ottiene automaticamente il suo worktree e branch isolati. Niente più agenti che si pestano i piedi a vicenda.

7. Usa Checkpoint + /rollback

Gli errori capitano. Va bene così. Hermes ti permette di creare checkpoint durante una sessione e di tornare a essi se qualcosa va storto. È come avere un pulsante “annulla” per le azioni del tuo agente.

8. Combina Worktree, Branch e Checkpoint

Ecco la formula vincente:

• Worktree = checkout puliti per ogni sessione
• Branch = cronologia ad alto livello degli esperimenti
• Checkpoint + /rollback = recupero rapido dagli errori

Insieme, ti danno iterazione veloce, recupero facile e pull request pulite.

9. Gestisci lo Sviluppo UI in Modo Intelligente

Se stai lavorando sulla TUI o sull’app desktop attraverso più worktree, avrai bisogno di node_modules per ciascuno. Sono molti file duplicati. Dai un’occhiata agli helper htui / hgui che condividono un’unica installazione tramite symlink — risparmi spazio su disco e tempo di configurazione.

10. Mantieni Pulito il Tuo Branch Principale

Il punto centrale di queste pratiche è mantenere il tuo branch principale stabile e pronto per la produzione. Unisci i branch dei worktree solo quando sono testati e completi.

---

Riepilogo

Pensa ai worktree come a scrivanie separate in un ufficio. Ogni agente Hermes ha la sua scrivania con i suoi strumenti, così nessuno rovina il lavoro degli altri. I branch sono il tuo sistema di archiviazione, e i checkpoint sono i tuoi post-it con scritto “sono stato qui”.

Consiglio pratico: Inizia semplicemente con hermes -w per il tuo prossimo task. È il modo più semplice per ottenere l’isolamento senza alcuna configurazione manuale. Una volta che ti senti a tuo agio, aggiungi checkpoint e rollback al tuo flusso di lavoro. Ti chiederai come hai fatto a lavorare senza.

---