Mejores Prácticas — 10 Consejos | Easy Understand Hermes Agent

Piensa en Hermes Agent como un chef en una cocina muy ocupada. No dejarías que cada cocinero cortara verduras en la misma tabla mientras emplata postres — le darías a cada uno su propia estación. La misma lógica aplica a tu código.

1. Un Worktree por Experimento

Imagina que estás pintando una casa. No pintarías la sala y el baño al mismo tiempo con la misma brocha — arruinarías ambas. Los worktrees de Git te permiten darle a cada tarea de Hermes su propia “habitación” para trabajar.

En lugar de dejar que Hermes edite archivos directamente en tu carpeta principal del proyecto, crea un espacio de trabajo separado para cada experimento. Esto mantiene tu código principal a salvo y tus cambios ordenados.

2. Nombra las Ramas Según el Experimento

Dale a tus ramas nombres claros y descriptivos para que tú (y tu yo del futuro) sepas para qué sirve cada una:

git checkout -b feature/hermes-checkpoints-docs

Nada de branch-1 o test-fix. Sé específico — te lo agradecerás más tarde.

3. Haz Commits con Frecuencia

Piensa en los commits como guardar tu progreso en un videojuego. No quieres jugar tres horas y luego perderlo todo porque no guardaste.

Haz commits en hitos importantes:

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

Para cambios más pequeños y dirigidos por herramientas en el medio, usa los checkpoints de Hermes y /rollback como red de seguridad.

4. Evita Ejecutar Desde la Raíz del Repo Desnudo

Cuando uses worktrees, no ejecutes Hermes desde la carpeta original del repositorio. En su lugar, haz cd al directorio del worktree. Esto le da a cada agente un alcance claro y previene la contaminación cruzada accidental.

5. Usa `hermes -w` para Worktrees Automáticos

¿No quieres configurar worktrees manualmente? Hermes tiene un atajo integrado:

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

Esto crea automáticamente un worktree desechable con su propia rama. Incluso puedes combinarlo con una sola consulta:

hermes -w -z "Fix issue #123"

6. Ejecuta Agentes en Paralelo de Forma Segura

¿Quieres que varios agentes de Hermes trabajen a la vez? Solo abre varias terminales y ejecuta hermes -w en cada una. Cada sesión obtiene su propio worktree y rama aislados automáticamente. Se acabó que los agentes se pisen los pies entre sí.

7. Usa Checkpoints + `/rollback`

Los errores pasan. No pasa nada. Hermes te permite crear checkpoints durante una sesión y volver a ellos si algo sale mal. Es como tener un botón de “deshacer” para las acciones de tu agente.

8. Combina Worktrees, Ramas y Checkpoints

Aquí está la fórmula ganadora:

Worktrees = checkouts limpios para cada sesión
Ramas = historial de alto nivel de los experimentos
Checkpoints + /rollback = recuperación rápida de errores

Juntos, te dan iteración rápida, recuperación fácil y pull requests limpios.

9. Maneja el Desarrollo de UI de Forma Inteligente

Si estás trabajando en la TUI o la app de escritorio en varios worktrees, necesitarás node_modules para cada uno. Eso es un montón de archivos duplicados. Echa un vistazo a los helpers htui / hgui que comparten una sola instalación mediante symlink — ahorra espacio en disco y tiempo de configuración.

10. Mantén tu Rama Principal Limpia

El objetivo de todas estas prácticas es mantener tu rama principal estable y lista para producción. Solo fusiona ramas de worktrees cuando estén probadas y completas.

Resumen

Piensa en los worktrees como escritorios separados en una oficina. Cada agente de Hermes tiene su propio escritorio con sus propias herramientas, así nadie arruina el trabajo de otro. Las ramas son tu sistema de archivo, y los checkpoints son tus notas adhesivas de “yo estuve aquí”.

Consejo práctico: Empieza solo con hermes -w para tu próxima tarea. Es la forma más fácil de obtener aislamiento sin configuración manual. Una vez que te sientas cómodo, añade checkpoints y rollback a tu flujo de trabajo. Te preguntarás cómo trabajabas sin ellos.