Private
Public Access
0
0
Commit Graph

4 Commits

Author SHA1 Message Date
ed a6038cb49a docs(tier2): reconcile guide with Tier 2's project-relative paths
Three path updates in docs/guide_tier2_autonomous.md to match the
actual code defaults (project-relative, in tests/artifacts/):

  - Bootstrap callout block: scripts/tier2/state/ and
    scripts/tier2/failures/ -> tests/artifacts/tier2_state/ and
    tests/artifacts/tier2_failures/
  - 'The failure report' section: scripts/tier2/failures/ ->
    tests/artifacts/tier2_failures/
  - Troubleshooting: 'Failcount state not found' and 'Tier 2 ran out
    of context' both point at the right path now.

Refs: conductor/tracks/tier2_no_appdata_20260618 (post-merge followup)
2026-06-18 18:27:13 -04:00
ed 64bee77f9f docs(tier2): guide_tier2_autonomous - replace AppData paths with inside-clone
Four updates to docs/guide_tier2_autonomous.md:

1. Bootstrap step 5: removed the AppData dir creation step;
   added a callout block explaining the 2026-06-18 reversal
   ('NEVER USE APPDATA', default locations are scripts/tier2/state/
   and scripts/tier2/failures/).

2. Hard bans table row: 'File access outside Tier 2 clone + app-data
   dir' -> 'File access outside Tier 2 clone (AppData, Temp,
   Documents, etc. all denied)'; the layer-1 enforcement is now
   described as 'permission.read/write path allowlist + *AppData\\*
   bash deny'.

3. Failure report location: C:\\Users\\Ed\\AppData\\Local\\manual_slop\\tier2_failures\\
   -> scripts/tier2/failures/ (inside the Tier 2 clone).

4. Troubleshooting: 'Failcount state not found' and 'Tier 2 ran out
   of context' no longer reference <app-data>; they point at
   scripts/tier2/state/<track>/ and \C:\Users\Ed\AppData\Local is dropped.

Refs: conductor/tracks/tier2_no_appdata_20260618
2026-06-18 14:41:12 -04:00
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
ed 8bf7cd175b docs(tier2): add user guide for Tier 2 autonomous sandbox 2026-06-16 22:48:13 -04:00