Hermes 에이전트는 --worktree 사용 후 .env, .venv, 의존성을 찾지 못하는데, 보통 워크트리가 고장 나서가 아니라 git이 이 파일들을 무시하고 자동으로 분리된 워크트리에 복사되지 않기 때문입니다. 해결책은 저장소 루트에 .worktreeinclude을 추가하는 것입니다.
왜 그런 일이 일어났는지
워크트리의 목적은 여러 에이전트가 서로 간섭하지 않고 병렬로 코드를 수정할 수 있도록 하는 것입니다. 이 워크트리는 Git 저장소를 기반으로 새로운 워크트리를 생성하지만, .gitignore가 무시하는 파일들은 로컬 키, 가상 환경, 의존 캐시, 개인 설정 등 저장소 내용에 속하지 않습니다.
추천 글
프로젝트 루트 디렉터리에 .worktreeinclude를 만들고 복사해야 할 로컬 파일을 한 줄씩 작성하세요:
.env.venv/node_modules/apps/web/.env.local
안전 경계에 주의하세요
모든 키가 병렬 에이전트에 복사되어야 하는 것은 아닙니다. 워크트리가 프론트엔드 스타일링만 담당한다면, 프로덕션 데이터베이스 키를 부여해서는 안 됩니다. 테스트 환경이나 읽기 전용 권한만 포함하는 간소화된 .env.local을 준비할 수 있습니다.
또한 워크트리는 병렬 코드 작업에 적합하며 장기적인 정체성 격리에는 적합하지 않습니다. 프로파일은 장기적인 역할 차이에 사용되어야 하며, 워크트리는 코드 변경 격리에 사용해야 합니다. 두 가지를 분리하면 Hermes 멀티태스킹 협업이 훨씬 더 안정적일 것입니다.
