Grok WorldGrok Build CLI field station

GROK BUILD CLI / 08

Worktrees と subagents で並列化する

Parallel agents は ownership、isolation、evidence、merge responsibility が明確なときだけ throughput を高めます。

CHANNEL並列エンジニアリング / 上級 / 12 MIN
情報確認日2026-07-26
ORIGINOFFICIAL DOCS / PRIMARY

既知の 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