My problem was: for refactoring/renaming workflows Claude seems to run grep/ripgrep to enumerate occurrences of a symbol before renaming, but somehow misses some references, especially in test files or documentation. After renaming a symbol I would have failing tests, which Claude will dutifully fix, so not the worst problem. However the out-of-date documentation references slowly bite me in the neck because in future, Claude might read the outdated docs and make false assumptions or wrong decisions.
So I made an mcp tool that searches an indexed repo for all references/usages of a symbol and returns ranked results.
https://gitlab.com/rhobimd-oss/shebe/-/blob/main/docs/guides...
Also recently there a ShowHN about a tool called nia that does something similar. https://docs.trynia.ai/tools-features