Лучшие Практики — 10 Советов

Думайте об Hermes Agent как о шеф-поваре на оживленной кухне. Вы же не позволите каждому повару резать овощи на одной разделочной доске, одновременно украшая десерты — вы дадите каждому свое рабочее место. Та же логика применима и к вашему коду.

1. Один Worktree на Эксперимент

Представьте, что вы красите дом. Вы же не будете красить гостиную и ванную одновременно одной и той же кистью — вы испортите обе. Git worktree позволяют дать каждой задаче Hermes свою собственную «комнату» для работы.

Вместо того чтобы позволять Hermes редактировать файлы напрямую в вашей основной папке проекта, создайте отдельное рабочее пространство для каждого эксперимента. Это сохранит ваш основной код в безопасности, а изменения — в порядке.

2. Называйте Ветки по Названию Эксперимента

Давайте веткам понятные, описательные имена, чтобы вы (и будущий вы) знали, для чего каждая из них:

git checkout -b feature/hermes-checkpoints-docs

А не branch-1 или test-fix. Будьте конкретны — потом скажете себе спасибо.

3. Делайте Коммиты Часто

Думайте о коммитах как о сохранении прогресса в видеоигре. Вы же не хотите играть три часа, а потом потерять всё, потому что не сохранились.

Делайте коммиты на ключевых этапах:

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

Для более мелких правок, управляемых инструментами, используйте чекпоинты Hermes и /rollback как страховочную сетку.

4. Избегайте Запуска из Корня Основного Репозитория

При использовании worktree не запускайте Hermes из исходной папки репозитория. Вместо этого выполните cd в директорию worktree. Это дает каждому агенту четкую область действий и предотвращает случайное перекрестное загрязнение.

5. Используйте `hermes -w` для Автоматических Worktree

Не хотите настраивать worktree вручную? У Hermes есть встроенный ярлык:

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

Это автоматически создает одноразовый worktree с собственной веткой. Вы даже можете объединить это с одним запросом:

hermes -w -z "Fix issue #123"

6. Запускайте Параллельных Агентов Безопасно

Хотите, чтобы несколько агентов Hermes работали одновременно? Просто откройте несколько терминалов и запустите hermes -w в каждом. Каждая сессия автоматически получает свой изолированный worktree и ветку. Больше никакой путаницы между агентами.

7. Используйте Чекпоинты + `/rollback`

Ошибки случаются. Это нормально. Hermes позволяет создавать чекпоинты во время сессии и откатываться к ним, если что-то пошло не так. Это как кнопка «отменить» для действий вашего агента.

8. Комбинируйте Worktree, Ветки и Чекпоинты

Вот выигрышная формула:

Worktree = чистые рабочие копии для каждой сессии
Ветки = высокоуровневая история экспериментов
Чекпоинты + /rollback = быстрое восстановление после ошибок

Вместе они дают вам быструю итерацию, легкое восстановление и чистые pull request’ы.

9. Умная Работа с UI-Разработкой

Если вы работаете над TUI или десктопным приложением в нескольких worktree, вам понадобятся node_modules для каждого. Это много дублирующихся файлов. Обратите внимание на помощники htui / hgui, которые используют одну установку через симлинк — это экономит место на диске и время настройки.

10. Держите Основную Ветку Чистой

Весь смысл этих практик — поддерживать вашу основную ветку стабильной и готовой к продакшену. Мержите ветки worktree только тогда, когда они протестированы и завершены.

Резюме

Думайте о worktree как об отдельных столах в офисе. Каждый агент Hermes получает свой собственный стол со своими инструментами, так что никто не испортит чужую работу. Ветки — это ваша система архивации, а чекпоинты — ваши стикеры с надписью «я был здесь».

Практический совет: Начните с простого hermes -w для вашей следующей задачи. Это самый легкий способ получить изоляцию без ручной настройки. Когда освоитесь, добавьте чекпоинты и откаты в свой рабочий процесс. Вы удивитесь, как вы раньше работали без них.