Files
cleveragents-core/docs/reference
HAL9000 60f872b7fb docs(spec): describe git worktree sandbox path via temp dir placeholder
The GitWorktreeSandbox implementation (PR #5998) creates worktrees in the
system temp directory using tempfile.mkdtemp() with the prefix
ca-sandbox-<plan_id>-, producing OS-specific paths (e.g.,
&lt;SYSTEM_TEMP_DIR&gt;/ca-sandbox-<PLAN_ULID>-XXXXXX/).

The spec previously showed the worktree path as a .worktrees/ subdirectory
inside the repository (e.g., /repos/api/.worktrees/plan-01HXM8). This was
incorrect and inconsistent with the implementation.

Changes:
- Update all plan execute output examples (Rich/Plain/JSON/YAML) to use the
  <SYSTEM_TEMP_DIR> prefix placeholder instead of hard-coding /tmp
- Update the end-to-end workflow examples (strategize + execute panels)
- Add explicit documentation of the git worktree path format in the
  Sandbox Implementation Strategies section, including rationale
- Update the changelog to reference the cross-platform placeholder

Triggered by: merged PR #5998 (GitWorktreeSandbox implementation)
ISSUES CLOSED: #6343
2026-04-28 09:25:24 +00:00
..
2026-02-23 03:11:12 +00:00
2026-03-04 22:40:34 +00:00