speq-code-tools · diff
git:20260720.15e76d6 to git:20260825.d3fff94
1 added, 1 removed. Audit A to A.
---
name: speq-code-tools
- description: Semantic code navigation and editing via Serena MCP — symbol-level tools preferred over grep/find/manual edits. Triggered by /speq-mission, /speq-implement, planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.
+ description: Semantic code navigation and editing via Serena MCP — symbol-level tools preferred over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.
---
# Code Tools
Semantic code navigation and editing via Serena MCP.
## Tool Preference
| Task | Use | Not |
|------|-----|-----|
| List directory | `list_dir` | `ls`, `find` |
| Find files | `find_file` | `find`, `rg --files` |
| File symbols | `get_symbols_overview` | `rg "class\|function"` |
| Symbol definition | `find_symbol` | `rg "function foo"` |
| Symbol references | `find_referencing_symbols` | `rg "foo("` |
| Update function | `replace_symbol_body` | read/edit/write |
| Insert after | `insert_after_symbol` | read/edit/write |
| Insert before | `insert_before_symbol` | read/edit/write |
| Rename symbol | `rename_symbol` | `rg` + manual edits |
## Reflection Checkpoints
Apply the **Feynman Technique** — explain your understanding before proceeding. Call these tools at key moments:
| Tool | When |
|------|------|
| `think_about_collected_information` | After exploration sequence |
| `think_about_task_adherence` | Before writing code |
| `think_about_whether_you_are_done` | Before reporting completion |
## Workflow
```
Explore → find_symbol, get_symbols_overview
Understand → find_referencing_symbols
Reflect → think_about_collected_information
Edit → replace_symbol_body, insert_*_symbol
Verify → find_referencing_symbols
Complete → think_about_whether_you_are_done
```