chore(tools/lsp): improve LSP tool descriptions

Christian Rocha created

Change summary

internal/agent/tools/diagnostics.md | 2 +-
internal/agent/tools/lsp_restart.md | 2 +-
internal/agent/tools/references.md  | 2 +-
3 files changed, 3 insertions(+), 3 deletions(-)

Detailed changes

internal/agent/tools/diagnostics.md 🔗 

@@ -1,4 +1,4 @@
-Get diagnostics for file and/or project.
+Get LSP errors, warnings, and hints for a file or the whole project.
 
 <usage>
 - Provide file path to get diagnostics for that file

internal/agent/tools/lsp_restart.md 🔗 

@@ -1,4 +1,4 @@
-Restart LSP (Language Server Protocol) clients.
+Restart one or all LSP clients by name; use when diagnostics are stale or the LSP is unresponsive.
 
 <usage>
 - Restart all running LSP clients or a specific LSP client by name

internal/agent/tools/references.md 🔗 

@@ -1,4 +1,4 @@
-Find all references to/usage of a symbol by name using the Language Server Protocol (LSP).
+Find all references to a symbol by name via LSP; more accurate than grep for code symbols.
 
 <usage>
 - Provide symbol name (e.g., "MyFunction", "myVariable", "MyType").