fix working directory issues

README.md

@@ -2,6 +2,16 @@
 
 Living reference for session management, keymaps, commands, and plugin-specific features in this config.
 
+## Working Directory Behavior
+
+The working directory (`:pwd`) is locked to the directory where you opened Neovim and does NOT change when switching files:
+
+- `autochdir` is disabled (working directory stays fixed at project root)
+- `netrw_keepdir = 1` prevents netrw from changing directory when browsing
+- Project root is captured at startup in `vim.g.project_root` (used by Telescope and netrw)
+- Telescope searches from the initial project root regardless of current buffer
+- Use `:cd <path>` to manually change directory if needed (affects Telescope search scope)
+
 ## Session Management
 
 Session support is automatic but user-controlled: