Grok WorldGrok Build CLI field station

最新号 / GROK BUILD

worktree storage を自分で回収すべき state として扱う

worktree session は ~/.grok/worktrees 配下の実際の git checkout で、現在の HEAD から始まり、生成した session より長く残り、明示的に削除したときだけ回収されます。

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

  1. 01

    contract を lock

    caller、data classification、success condition、timeout、cancel、ownership を記述します。parallel agent、長い review、定期実行が共有または容量制限のある disk に isolated checkout を蓄積する場合に使う。

  2. 02

    bounded path を実行

    correlation、typed state、reversible failure を持つ一つの end-to-end path を作ります。worktree session は ~/.grok/worktrees 配下の実際の git checkout で、現在の HEAD から始まり、生成した session より長く残り、明示的に削除したときだけ回収されます。

  3. 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'