docs: reorganize file_cache.py with region tags and update tooling guidelines

2026-05-13 22:30:42 -04:00
parent 0741b5e69f
commit 737b9f31e6
2 changed files with 13 additions and 4 deletions
@@ -40,6 +40,7 @@
    *   `manual_slop.toml`: Per-project settings (files to track, discussion history, specific system prompts).
 *   **Tool Execution:** The AI acts primarily by generating PowerShell scripts. These scripts MUST be confirmed by the user via a GUI modal before execution. The AI also has access to read-only MCP-style file exploration tools and web search capabilities.
 *   **Context Refresh:** After every tool call that modifies the file system, the application automatically refreshes the file contents in the context using the files' `mtime` to optimize reads.
+*   **Sequential Tooling:** Tools that rely on line numbers (e.g., `py_region_wrap`, `get_file_slice`, `set_file_slice`) MUST be executed sequentially across multiple turns. Never batch multiple line-dependent operations in a single turn, as preceding edits will cause line drift and corrupt subsequent operations.
 *   **UI State Persistence:** Window layouts and docking arrangements are automatically saved to and loaded from `dpg_layout.ini`.
 *   **Code Style:**
    *   Use type hints where appropriate.