docs(tools): refresh tool reference and prompt guidance

- add symbol-based code navigation guidance to docs prompt examples
- clarify tool result truncation limits and simplify tools page copy

src/pages/docs.astro

@@ -462,6 +462,8 @@ import BaseLayout from '../layouts/BaseLayout.astro';
 - Verify libraries exist before using them (check imports, package.json, etc.)
 - Use absolute file paths
 - Read files before editing them
+- Prefer symbol_search -> symbol_resolve -> read_file_range for code understanding
+- Use grep_search when you need text-pattern search rather than symbol lookup
 - Add comments sparingly - focus on "why" not "what"
 - If unclear, ask for clarification
 
@@ -474,14 +476,18 @@ import BaseLayout from '../layouts/BaseLayout.astro';
 
 # Available Tools
 
-**get_workspace_structure** - Get project directory tree
-**list_dir** - List files/directories in a path
-**read_file** - Read file contents  
+**get_editor_state** - Get active file, cursor position, and open files
+**symbol_search** - Find functions, classes, methods, and types by name
+**symbol_resolve** - Resolve a symbol to its exact file and line range
+**symbol_references** - Find where a symbol is used
+**read_file_range** - Read targeted line ranges from a file
+**read_file** - Read full file contents when broader context is needed
+**get_workspace_structure** - Get the project directory tree
+**grep_search** - Search for text or regex patterns across files
+**apply_patch** - Make precise edits to existing files
 **write_file** - Create or overwrite a file
-**apply_patch** - Replace specific content in a file (for edits)
-**grep_search** - Search for patterns across files
 **run_command** - Execute shell commands
-**get_editor_state** - Get currently open file and cursor position</code></pre>
+**todo_write** - Track multi-step work and show progress</code></pre>
           </div>
           
           <p class="instructions-note">