Merge claudedo/0d0aa8b0fad9484cab532cc19709ec13

src/ClaudeDo.Data/PromptFiles.cs

@@ -98,6 +98,19 @@ public static class PromptFiles
           just restate the code.
         - Validate only at real boundaries (user input, external APIs).
 
+        ## Reading efficiently
+        - Locate before reading: use Grep/Glob to find the relevant spot instead of
+          opening files to look around.
+        - Read narrowly: pass `offset`/`limit` for the relevant section. Read a whole file
+          only when you already know you need all of it — for files over ~400 lines that's
+          rarely the case.
+        - Don't re-read: check whether the content is already in context before reading it
+          again.
+        - For orientation questions ("where is X", "how does Y work", "which files touch
+          Z"), dispatch an exploration subagent instead of reading broadly yourself — the
+          file dump stays in its context, only the summary comes back. Skip the subagent
+          for a single targeted read or edit; the overhead isn't worth it there.
+
         ## Finishing
         - Before claiming done, verify: run the build and relevant tests, confirm they
           pass, and report what you ran. If you couldn't verify something, say so plainly.