summaryrefslogtreecommitdiff
path: root/constrain/AGENTS.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-08-02 12:36:54 -0300
committerGabriel Schneider <[email protected]>2026-08-02 17:37:58 -0300
commite16f78b255bcf46d8c6f9a4b9e76dd7a3817edeb (patch)
treede0db0c369522b5bf92ff32a8351de2224c5c9dc /constrain/AGENTS.md
parent151ea12251ed876aa87bb486da1bc337e25369e9 (diff)
downloadnotevi-e16f78b255bcf46d8c6f9a4b9e76dd7a3817edeb.tar.gz
notevi-e16f78b255bcf46d8c6f9a4b9e76dd7a3817edeb.zip
Diffstat (limited to 'constrain/AGENTS.md')
-rw-r--r--constrain/AGENTS.md6
1 files changed, 5 insertions, 1 deletions
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.