01 / DECIDE
Architecture decision
parallel agent、長い review、定期実行が共有または容量制限のある disk に isolated checkout を蓄積する場合に使う。
worktree session は ~/.grok/worktrees 配下の実際の git checkout で、現在の HEAD から始まり、生成した session より長く残り、明示的に削除したときだけ回収されます。 input、output、state、tool、side effect を一つの観測可能な経路にし、worktree storage を自分で回収すべき state として扱う の owner を決めます。
02 / OPERATE
3段階の field procedure
- 01
contract を lock
caller、data classification、success condition、timeout、cancel、ownership を記述します。parallel agent、長い review、定期実行が共有または容量制限のある disk に isolated checkout を蓄積する場合に使う。
- 02
bounded path を実行
correlation、typed state、reversible failure を持つ一つの end-to-end path を作ります。worktree session は ~/.grok/worktrees 配下の実際の git checkout で、現在の HEAD から始まり、生成した session より長く残り、明示的に削除したときだけ回収されます。
- 03
signal を検証
acceptance を再実行可能な fixture、contract test、browser test にします。インストール済み version とその release notes、その build が実際に備える worktree command の help 出力、dry-run preview、削除後に回収された path を記録する。
03 / BOUND
Operational boundary
session を終了・削除しても worktree は残り、回収は呼び出したときだけ実行されます。preview なしの削除は git で land していない変更を失う恐れがあります。
04 / PROVE
Acceptance evidence
インストール済み version とその release notes、その build が実際に備える worktree command の help 出力、dry-run preview、削除後に回収された path を記録する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://docs.x.ai/build/features/worktrees' | sed -n '1,5p'