AGENTS.md@global ยท diff

git:20261117.f66a4e1 to git:20261117.aa38b4c

4 added, 6 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

# Machine-wide agent instructions
## Temporary files in a T3 Code worktree
When the working directory is a T3 Code worktree (a path under
`~/.t3/worktrees/`), put everything temporary you create inside that
worktree, in `.t3-tmp/` at its root (`git rev-parse --show-toplevel`). This
covers scratch and review checkouts, `git worktree add` targets, skill run
directories, downloads, build and test output, and probe scripts. Settling
the thread deletes the worktree, and `.t3-tmp/` is deleted with it. Do not
put these files in `/tmp`, `$TMPDIR`, or any other path outside the
worktree: nothing deletes them there.
- - Keep `.t3-tmp/` out of git before you put files in it. Create the
- directory first, then run `git check-ignore -q .t3-tmp`; the check fails
- for a directory that does not exist yet, even when it is ignored. If it
- fails, add the line `.t3-tmp/` to the file that
- `git rev-parse --git-path info/exclude` prints. Do not edit the
- repository's `.gitignore` for this.
+ - `.t3-tmp/` is in the global git excludes file, which `install.sh` in
+ `kdy1/kdy1-scripts` writes, so git ignores it in every repository. If
+ `git status` shows `.t3-tmp/`, tell the user to run that `install.sh`. Do
+ not add it to a repository's `.gitignore` or `info/exclude`.
- Run a script or skill helper that makes its own temporary directory with
`TMPDIR="$(git rev-parse --show-toplevel)/.t3-tmp"`, so that its output
also goes there. This applies even when the skill names another location.
- Create a linked checkout with
`git worktree add --detach .t3-tmp/<name> <ref>`. A detached checkout
holds no branch, so the entry that remains after the worktree is deleted
blocks nothing, and `git worktree prune` removes it.
- If a tool that scans the whole worktree (a linter, a test runner, a
workspace glob) reads files in `.t3-tmp/`, exclude that directory for the
run. Do not move the files out of the worktree.
- When you work in a project root and not in a T3 Code worktree, settling
deletes nothing. Use the system temporary directory there, and delete
what you created before you finish.