From 3c51f8b9b3cae6ae589de5c37e8ffa37eff7ea12 Mon Sep 17 00:00:00 2001 From: dayfine Date: Mon, 2 Nov 2026 22:40:58 -0800 Subject: [PATCH] AGENTS.md: add a Disk rule (keep 30 GB free, clean up own temp trees) Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01AKYzhrMnPK61XHWEch4a6E --- AGENTS.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 54b00db94f..ce8f6c26c4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,6 +27,7 @@ code branches keep only a stub workflow that checks this branch out to run it. O | Console runs: a failure becomes a sim regression test, wait by detector, FRLG has one save slot | [Console automation](#console-automation-bdsp-and-frlg-autostory) | Red test before the fix; no fixed delays; never rerun an earlier checkpoint on a later save. | | C++ style, incl. `std::string_view` by value | [C++ style](#c-style), [Code conventions](#code-conventions-for-pr-branches) | Repo style first, then Google/Abseil as adopted there. | | Shell commands | [Commands: keep them tight](#commands-keep-them-tight) | One purpose per command, no broad scans, no `rm` on globs. | +| Disk: keep ≥ 30 GB free; remove your own temp trees | [Disk](#disk) | `df -h ~` before a build, clone or CommandLineTests checkout; below 30 GB, stop and report. | **Agents and skills** @@ -77,7 +78,7 @@ There are two different checks, and neither replaces the other: | BBQ notes and run records | [pokemon_sv/](pokemon_sv/) ([where to look first](#plans-and-state-where-to-look-first)) | Milestones, ledgers, runs. | | Harness and trial records | [harness/](harness/) | ccache trial, FRLG license notes, issue #40 state. | | Fork branch sync | launchd `com.dayfine.pa-sync`, 07:00: `~/Projects/pa-tools/sync_branches.py` | Needs `~/.zshenv` for `GH_TOKEN`. Logs: `~/Library/Logs/pa-sync/`. | -| Lab disk GC | launchd `com.dayfine.lab-disk-gc`, 06:30: `~/BDSPLab/disk_gc.sh --apply` | Old shots, builds, idle pushed worktrees. Log: `~/Library/Logs/lab-disk-gc/gc.log`. Extend it, don't add jobs. | +| Lab disk GC | launchd `com.dayfine.lab-disk-gc`, 06:30 daily and hourly when low: `~/BDSPLab/disk_gc.sh --apply` | Old shots, builds, idle pushed worktrees. Log: `~/Library/Logs/lab-disk-gc/gc.log`. Extend it, don't add jobs. | ## Session startup from a code checkout @@ -134,6 +135,20 @@ obviously safe. they walk network volumes and trigger macOS privacy prompts. Use explicit paths. - **Wait with one background command,** not chained `sleep`s. +## Disk + +Keep disk under control on this Mac (the user's request, 2026-11-02). + +- **Keep at least 30 GB free.** Run `df -h ~` before any build, clone or CommandLineTests + checkout. Below 30 GB, stop and report instead of starting. +- **Prefer sparse or blobless clones** (`--filter=blob:none`, `git sparse-checkout`), and one build + folder per tree. +- **Whoever creates a temp worktree or clone removes it** when the task ends, once it is clean and + pushed: `git worktree remove `, or delete the clone. +- **The disk GC job is a backstop, not your cleanup.** `~/BDSPLab/disk_gc.sh` (launchd + `com.dayfine.lab-disk-gc`, daily and hourly when low) removes idle clean pushed trees under + `~/.claude/jobs/*/tmp` and `/private/tmp/claude-wt`. Don't rely on it for your own. + ## Roles - **Codex owns:**