1 files changed, 11 insertions, 0 deletions

diff --git a/constrain/AGENTS.md b/constrain/AGENTS.md
new file mode 100644
index 0000000..abec095
--- /dev/null
+++ b/constrain/AGENTS.md
@@ -0,0 +1,11 @@
+# Reading code here
+
+Files are read with the `vr` tool — run `vr -doc` once for full usage.
+
+- `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.