Hermes Agentは--worktreeを使った後、.env、.venv、依存関係を見つけられません。通常はワークツリーが壊れているからではなく、これらのファイルがgitに無視され、新しく隔離されたワークツリーに自動的にコピーされていないためです。解決策はリポジトリのルートに.worktreeincludeを追加することです。
なぜそうなったのか
ワークツリーの目的は、複数のエージェントが互いに干渉せずに並行してコードを変更できるようにすることです。Gitリポジトリを基に新しいワークツリーを作成しますが、.gitignoreが無視したファイル(ローカルキー、仮想環境、依存キャッシュ、プライベート設定など)はリポジトリの内容には属しません。
おすすめの著作
プロジェクトのルートディレクトリに.worktreeincludeを作成し、コピーが必要なローカルファイルを一行ずつ書きます:
.env.venv/node_modules/apps/web/.env.local
安全境界に注意してください
すべてのキーを並列エージェントにコピーすべきではありません。もしワークツリーがフロントエンドのスタイリングのみを担当しているなら、本番データベースキーを与えるべきではありません。テスト環境や読み取り専用権限のみを含む簡素な .env.local を作成することもできます。
さらに、ワークツリーは並列コードタスクに適しており、長期的なアイデンティティ分離には適していません。プロファイルは長期的な役割の違いに、ワークツリーはコード変更の分離に使うべきです。両者を分離すると、ヘルメスのマルチタスク協働ははるかに安定します。
