diff --git a/docs/guide_tier2_autonomous.md b/docs/guide_tier2_autonomous.md index 1fc8e0ce..a928589e 100644 --- a/docs/guide_tier2_autonomous.md +++ b/docs/guide_tier2_autonomous.md @@ -23,7 +23,7 @@ The bootstrap: 4. Installs the git hooks (`pre-push` refuses all pushes; `post-checkout` logs checkouts) 5. Creates a "Tier 2 (Sandboxed)" desktop shortcut -**As of 2026-06-18:** the bootstrap no longer creates any directory on AppData. Tier 2 state and failure reports live inside the clone at `scripts/tier2/state//state.json` and `scripts/tier2/failures/_.md`. The user directive is "NEVER USE APPDATA" — enforced by the OpenCode `*AppData\\*` bash deny rule. +**As of 2026-06-18:** the bootstrap no longer creates any directory on AppData. Tier 2 state and failure reports live at `tests/artifacts/tier2_state//state.json` and `tests/artifacts/tier2_failures/_.md` (project-relative; inside the project tree under the already-gitignored `tests/artifacts/`). The user directive is "NEVER USE APPDATA" — enforced by the OpenCode `*AppData\\*` bash deny rule. ## Per-track invocation @@ -70,7 +70,7 @@ Override via `scripts/tier2/failcount.toml`. ## The failure report -Written to `scripts/tier2/failures/_.md` (inside the Tier 2 clone, relative to the clone root) with 7 sections: +Written to `tests/artifacts/tier2_failures/_.md` (project-relative; inside `tests/artifacts/` which is gitignored) with 7 sections: 1. Header (track, branch, started, stopped, duration, give-up signal) 2. Tasks completed 3. Current task (where it stopped) @@ -117,9 +117,9 @@ And verify allowed operations work: - **"Permission denied" on file access inside the sandbox**: the Windows ACL may be too restrictive. Re-run the bootstrap (`setup_tier2_clone.ps1` is idempotent). -- **"Failcount state not found"**: the `scripts/tier2/state//` +- **"Failcount state not found"**: the `tests/artifacts/tier2_state//` dir may be missing. The failcount module creates it on first save; - check that the Tier 2 clone's working directory is correct. + check that the Tier 2 clone's project root is correct. - **"Pre-push hook not firing"**: check that `.git/hooks/pre-push` is executable. On Windows, Git Bash runs the hook; check `git config core.hooksPath` if you have a custom hooks dir. @@ -127,6 +127,6 @@ And verify allowed operations work: `no_progress_minutes` in `scripts/tier2/failcount.toml`. - **"Tier 2 ran out of context"**: the model stopped mid-track. The user (interactive Tier 1) should `cd` to the Tier 2 clone, inspect - `scripts/tier2/state//state.json` for the last completed task, + `tests/artifacts/tier2_state//state.json` for the last completed task, and re-invoke with `/tier-2-auto-execute --resume` to continue. The state file persists across runs.