既知の base から分離作業を始める
Worktree session は ~/.grok/worktrees 下の実 git checkout を使います。default は current HEAD から始まり uncommitted changes も含むため、clean な指定 base が必要なら --ref を使います。
worktree に名前を付けると discovery と cleanup が明確です。checkout は base commit で detached なので、結果は通常の git review、commit、integration で取り込みます。
grok -w
grok --worktree=feat "refactor module X"
grok -w --ref main "fix the flaky test" 境界のある問題を subagents へ委譲する
Subagents は独自 context を持つ child sessions で、完了後 parent へ summary を返します。built-in general-purpose は全機能、explore は shell/edit なしの read/list/search、plan は shell/edit なしの計画作成です。
package、hypothesis、test surface、review concern など独立 ownership で分割します。各 child に具体的な output contract を与え、parent には summaries の連結ではなく evidence の検証を求めます。
- explore で repository map を作る。
- plan で独立 implementation proposal を作る。
- Child が編集する可能性には worktree を使う。
Fork・検査・cleanup を意図的に行う
/fork --worktree で現在 conversation を分離 checkout へ分岐します。session 終了後も worktree は残り、garbage collection は呼び出したときだけ動くため housekeeping も workflow の一部です。
削除前に list と inspect を行います。rm subcommand は --dry-run を持つため exact target を確認し、統合済みまたは意図的に破棄する worktree だけを除去します。
/fork --worktree
grok worktree list
grok worktree show <id>
grok worktree rm --dry-run <id>
grok worktree gc --max-age 7d