Serena Navigator

---
name: serena-navigator
description: |
  This skill should be used when the user asks to "navigate code efficiently",
  "find function definition", "understand file structure", "explore codebase",
  "get symbols overview", "find symbol usages", or mentions Serena's LSP tools
  like get_symbols_overview, find_symbol, find_referencing_symbols.
---

# Serena Semantic Navigation

## Token-Efficient Reading Pattern

Instead of reading entire files:

1. **Get overview first**: `get_symbols_overview(file)` - See all functions/classes
2. **Locate specific symbol**: `find_symbol(name)` - Get exact location
3. **Read targeted section**: `read_file(path, start_line, end_line)` - Only what's needed

This pattern saves 90%+ tokens on large files.

## Tool Selection Guide

| Task | Tool |
|------|------|
| See file structure | `get_symbols_overview(file_path)` |
| Find definition | `find_symbol(name)` |
| Find all usages | `find_referencing_symbols(symbol_name)` |
| Search text/comments | `search_for_pattern(pattern)` |

## Example Workflow: Understanding Code

```
1. get_symbols_overview("src/services/payment.py")
   → See PaymentProcessor class with all methods

2. find_symbol("process_payment")
   → Get exact location and signature

3. find_referencing_symbols("process_payment")
   → Find all call sites

4. read_file("src/services/payment.py", start_line=45, end_line=80)
   → Read only the relevant method
```

## When to Use Text Search

Use `search_for_pattern` for:
- String literals and comments
- Configuration values
- Non-code patterns

## Memory Integration

Check existing project knowledge:
```
list_memories()
read_memory("architecture_overview")
```

Save discoveries:
```
write_memory(key="architecture_overview", content="...")
```