Skip to main content

Worktree

Questo repository preferisce worktree separati rispetto a modifiche non correlate accumulate in un unico checkout. Questo conta sia per gli esseri umani che per gli agent:
  • meno sovrapposizioni accidentali
  • confini di revisione più netti
  • minor rischio di dover fare revert di lavoro non correlato
  • convalida parallela più semplice

Pattern predefinito

Usa un worktree per ogni funzionalità o correzione coerente. Esempio:
L’helper crea per impostazione predefinita una directory worktree sorella sotto ../worktrees.

Quando usare un worktree

  • una funzionalità richiederà più di un commit
  • vuoi mantenere il lavoro su release o documentazione isolato dal lavoro sul runtime
  • più agent o contributori stanno lavorando in parallelo
  • devi confrontare due approcci senza inquinare il checkout principale

Regole

  • un branch per ogni worktree
  • un ambito principale per ogni branch
  • non mescolare un ampio churn di dipendenze nei branch delle funzionalità
  • non usare i worktree per nascondere in una PR lavoro non correlato e incompiuto

Leggi anche