Praktik Terbaik — 10 Tips

Bayangkan Hermes Agent seperti seorang koki di dapur yang sibuk. Kamu tidak akan membiarkan setiap juru masak memotong sayuran di talenan yang sama sambil juga menata hidangan penutup — kamu akan memberi mereka stasiun kerja masing-masing. Logika yang sama berlaku untuk codebase kamu.

---

1. Satu Worktree untuk Setiap Eksperimen

Bayangkan kamu sedang mengecat rumah. Kamu tidak akan mengecat ruang tamu dan kamar mandi pada saat yang sama dengan kuas yang sama — hasilnya akan berantakan. Git worktree memungkinkan kamu memberikan “ruangan” sendiri untuk setiap tugas Hermes.

Daripada membiarkan Hermes mengedit file secara langsung di folder proyek utama kamu, buatlah workspace terpisah untuk setiap eksperimen. Ini menjaga kode utama kamu tetap aman dan perubahan kamu tetap rapi.

2. Beri Nama Branch Sesuai Eksperimen

Beri nama branch yang jelas dan deskriptif agar kamu (dan kamu di masa depan) tahu kegunaan masing-masing:

git checkout -b feature/hermes-checkpoints-docs

Bukan branch-1 atau test-fix. Bersikaplah spesifik — kamu akan berterima kasih pada dirimu sendiri nanti.

3. Lakukan Commit Secara Rutin

Anggap commit seperti menyimpan progres permainan di video game. Kamu tidak ingin bermain selama tiga jam lalu kehilangan semuanya karena tidak menyimpan.

Lakukan commit pada pencapaian penting:

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

Untuk perubahan kecil berbasis alat di antaranya, gunakan checkpoint Hermes dan /rollback sebagai jaring pengaman.

4. Hindari Menjalankan dari Root Repo Utama

Saat menggunakan worktree, jangan jalankan Hermes dari folder repo asli. Sebaliknya, cd ke direktori worktree. Ini memberikan ruang lingkup yang jelas untuk setiap agen dan mencegah kontaminasi silang yang tidak disengaja.

5. Gunakan hermes -w untuk Worktree Otomatis

Tidak ingin menyiapkan worktree secara manual? Hermes punya pintasan bawaan:

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

Ini otomatis membuat worktree sekali pakai dengan branch-nya sendiri. Kamu bahkan bisa menggabungkannya dengan satu perintah:

hermes -w -z "Fix issue #123"

6. Jalankan Agen Paralel dengan Aman

Ingin beberapa agen Hermes bekerja sekaligus? Cukup buka beberapa terminal dan jalankan hermes -w di masing-masing terminal. Setiap sesi otomatis mendapatkan worktree dan branch terisolasi sendiri. Tidak ada lagi agen yang saling mengganggu.

7. Gunakan Checkpoint + /rollback

Kesalahan itu wajar. Tidak masalah. Hermes memungkinkan kamu membuat checkpoint selama sesi dan kembali ke checkpoint tersebut jika terjadi kesalahan. Ini seperti memiliki tombol “undo” untuk tindakan agen kamu.

8. Gabungkan Worktree, Branch, dan Checkpoint

Inilah formula kemenangannya:

• Worktree = checkout yang bersih untuk setiap sesi
• Branch = riwayat eksperimen tingkat tinggi
• Checkpoint + /rollback = pemulihan cepat dari kesalahan

Jika digabungkan, semuanya memberi kamu iterasi cepat, pemulihan mudah, dan pull request yang bersih.

9. Tangani Pengembangan UI dengan Cerdas

Jika kamu mengerjakan aplikasi TUI atau desktop di beberapa worktree, kamu memerlukan node_modules untuk masing-masing. Itu banyak file duplikat. Lihatlah helper htui / hgui yang berbagi satu instalasi melalui symlink — ini menghemat ruang disk dan waktu pengaturan.

10. Jaga Branch Utama Kamu Tetap Bersih

Inti dari semua praktik ini adalah menjaga branch utama kamu tetap stabil dan siap produksi. Hanya gabungkan branch worktree ketika sudah diuji dan selesai.

---

Ringkasan

Anggap worktree sebagai meja kerja terpisah di kantor. Setiap agen Hermes mendapatkan meja sendiri dengan peralatannya sendiri, jadi tidak ada yang mengacaukan pekerjaan orang lain. Branch adalah sistem pengarsipan kamu, dan checkpoint adalah catatan tempel “saya pernah di sini”.

Tips praktis: Mulailah dengan hermes -w saja untuk tugas berikutnya. Itu cara termudah untuk mendapatkan isolasi tanpa pengaturan manual. Setelah kamu nyaman, tambahkan checkpoint dan rollback ke alur kerja kamu. Kamu akan heran bagaimana bisa bekerja tanpa semuanya itu.

---