From e16f78b255bcf46d8c6f9a4b9e76dd7a3817edeb Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Sun, 2 Aug 2026 12:36:54 -0300 Subject: --- constrain/AGENTS.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'constrain/AGENTS.md') diff --git a/constrain/AGENTS.md b/constrain/AGENTS.md index abec095..871fc6c 100644 --- a/constrain/AGENTS.md +++ b/constrain/AGENTS.md @@ -2,10 +2,14 @@ Files are read with the `vr` tool — run `vr -doc` once for full usage. +`vr` stores the trace in the repo's private local jj sidecar named `vr_log`. +Do not set `VR_LOG`, pass `-log`, or create a working-tree `vr-log.jsonl`. + - `vr read FILE:START-END` — line-numbered read; prefer ranges over whole files - `vr grep PATTERN [PATH]` — regex search; scope with a path - `vr read -r REV FILE`, `vr grep -r REV PATTERN PATH` — at another jj change - `vr note -f FILE:10-42 -t struct TEXT...` — record observations as you read Navigate top-down: grep for the symbol, read the enclosing range, note what -you learn. Reads and notes are keyed to the current jj change automatically. +you learn. Every entry records the full current jj change and commit IDs; the +sidecar append does not modify the project's working-copy change. -- cgit v1.3