From 4237065ed0a5713b7c9be15f3c948c8969a3d6c1 Mon Sep 17 00:00:00 2001 From: Scott Hanselman Date: Tue, 5 May 2026 17:55:28 -0700 Subject: [PATCH] Document agent validation worktree guidance Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index ff78ede..a5199a4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,5 +22,8 @@ If a command fails: Notes: - If a build/test is blocked by an environmental lock (for example running executable locking output assemblies), stop/close the locking process and rerun. +- In linked git worktrees, set `OPENCLAW_REPO_ROOT` to the worktree path before running tests that discover the repository root, for example: + - `$env:OPENCLAW_REPO_ROOT='D:\github\moltbot-windows-hub.'` - Tray tests must isolate `SettingsManager` from real user settings. Do not use `new SettingsManager()` in tests unless the test intentionally reads `%APPDATA%\OpenClawTray\settings.json`; pass a temp settings directory or set `OPENCLAW_TRAY_DATA_DIR` before the test process starts. +- Prefer isolated worktrees for PR validation. Use `git-wt` for worktree workflows; `wt.exe` may resolve to WorkTrunk instead of Windows Terminal, so use the full Windows Terminal path when explicitly launching Terminal. - Do not claim completion without reporting validation results.