Private

Public Access

Files

T

ed 07a0e66a19 docs(tier2): apply user feedback - 6 workflow conventions

User feedback from the first sandbox run (send_result_to_send_20260616,
2026-06-17) identified 6 conventions Tier 2 must follow. Update the agent
prompt template, slash command template, user guide, and workflow doc:

1. Test runner: ALWAYS use 'uv run python scripts/run_tests_batched.py'
   (NOT 'uv run pytest'). The batched runner provides tier filtering,
   parallelization (xdist), and a summary table that direct pytest lacks.

2. Default branch: this repo uses 'master', not 'main'. The Tier 2 slash
   command now does 'git fetch origin master' (was 'origin main').

3. Line endings: preserve existing. This repo has a mix of CRLF and LF;
   a repo-wide LF standardization is a future track.

4. Throw-away scripts: write to 'scripts/tier2/artifacts/<track>/', NOT
   the base 'scripts/tier2/' directory. The base is reserved for
   production code; throw-away scripts are kept for archival but
   isolated per-track.

5. End-of-track report: write 'docs/reports/TRACK_COMPLETION_<track>.md'
   and update 'state.toml' to 'status=completed'. The user reads this
   to decide merge. Previously this was implicit; now it's explicit.

6. Run-time expectation: tracks are 1-4 hours. If context runs out, Tier
   2 notes progress to disk and continues. The --resume flag picks up
   from the last completed task.

Also updated the user guide with a 'Conventions' section and a
troubleshooting entry for the resume flow. The verify-the-sandbox
checklist now uses 'origin master' instead of 'origin main'.

2026-06-17 02:13:29 -04:00

3.5 KiB

Raw Blame History

description, agent

description	agent
Autonomously execute a conductor track in the Tier 2 sandbox	tier2-autonomous

/tier-2-auto-execute

Run a track autonomously in the Tier 2 sandboxed mode. No permission: ask prompts.

Arguments

$ARGUMENTS - Track name (required). Examples: result_migration_review_pass, data_structure_strengthening_20260606. Optional flags: --resume (continue from last completed task), --toast (Windows toast on give-up).

Pre-flight

Verify sandbox is active. This slash command must be invoked from a sandboxed OpenCode session. If manual-slop_get_ui_performance returns an error or the run_tier2_sandboxed.ps1 wrapper is not in the parent process, refuse to start.
Load the track spec. Read conductor/tracks/<track-name>/spec.md and plan.md from the current branch. If the track does not exist, abort.
Check for a previous run. If <app-data>/tier2/<track-name>/state.json exists AND --resume is NOT set, abort with: "Previous run found for this track. Use --resume to continue, or delete the state file to start fresh."

Protocol

git fetch origin master (NOTE: this repo uses master, not main; added 2026-06-17)
git switch -c tier2/<track-name> origin/master (NOT git checkout - it is banned)
Initialize failcount state at <app-data>/tier2/<track-name>/state.json (use load_state or fresh state)
For each task in plan.md: a. Red: delegate test creation to @tier3-worker b. Run tests via uv run python scripts/run_tests_batched.py (NEVER uv run pytest directly; the batched runner provides tier filtering, parallelization, and the summary table — added 2026-06-17) c. If pass unexpectedly, call record_red_failure and check should_give_up d. Green: delegate implementation to @tier3-worker e. Run tests via scripts/run_tests_batched.py; if fail, call record_green_failure and check should_give_up f. On green: record_commit and record_green_success (resets counters) g. Commit per task with git add <specific files> && git commit -m "..." and attach git note h. Update plan.md with commit SHA
After all tasks complete, write the end-of-track report (see step 7) and print success summary.
On give-up: call write_failure_report from scripts.tier2.write_report, print "TRACK ABORTED, see report at ".
End-of-track report (added 2026-06-17): on success, write docs/reports/TRACK_COMPLETION_<track-name>.md following the precedent set by TRACK_COMPLETION_tier2_autonomous_sandbox_20260616.md. Update conductor/tracks/<track-name>/state.toml to status = "completed". The user reads this report to decide merge.

Conventions (MUST follow - added 2026-06-17)

Test runner: use uv run python scripts/run_tests_batched.py (NOT uv run pytest)
Default branch: master (this repo never had main)
Line endings: preserve existing (CRLF stays CRLF, LF stays LF)
Throw-away scripts: write to scripts/tier2/artifacts/<track-name>/, NOT the base directory
Run-time expectation: tracks are 1-4 hours. If context runs out, note progress to disk and continue.

Hard Bans (enforced by 3 layers)

git restore* (any form) — denied
git push* (any push) — denied
git checkout* (any form) — denied; use git switch instead
git reset* (any form) — denied

Filesystem access is restricted to the Tier 2 clone + <app-data>/manual_slop/tier2/. The Windows restricted token blocks reads/writes outside these paths at the OS level.

3.5 KiB Raw Blame History