エージェントを独立した git worktree で実行したい
9. エージェントコマンド / 機能
isolation: worktree（frontmatter）安全な隔離実行環境
概要
エージェント定義に isolation: worktree を設定すると、エージェントが一時的な git worktree（リポジトリのコピー）で実行されます。メインのコードベースを汚染せずに実験的な変更を行えます。
設定例
# .claude/agents/experimental.md
---
name: experimental-refactor
description: 実験的なリファクタリングを安全に試す
isolation: worktree
model: sonnet
---
あなたはリファクタリング専門家です。
worktree で安全に変更を試してから、問題なければ報告してください。
# CLIフラグでも指定可能
claude --worktree feature-auth
claude -w "my-experiment"こんな時に使う
- 実験的な変更をメインコードベースに影響させずに試したい時
- リスクのあるリファクタリングを安全に実行したい時
- 並列で複数の実験を行いたい時
使い方
- 1frontmatter に isolation: worktree を追加
- 2エージェントが自動で一時 worktree を作成して実行
- 3変更がなければ worktree は自動クリーンアップされる
Tips
- 変更がある場合は worktree のパスとブランチが返される
- --worktree / -w フラグで起動時に worktree を指定することも可能
- WorktreeCreate / WorktreeRemove フックでカスタマイズ可能