summaryrefslogtreecommitdiff
path: root/constrain/AGENTS.md
blob: 871fc6c33a1b05a5dd1896bf0981877a574ffcd4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Reading code here

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. Every entry records the full current jj change and commit IDs; the
sidecar append does not modify the project's working-copy change.