Deep Codebase Navigator FAQs

Question 1

Do I need to run the indexer manually?

Accepted Answer

Yes, it is recommended to run the provided indexing command at the start of each session or after significant structural changes to ensure the agent's map remains accurate.

Question 2

How does this skill help with large codebases?

Accepted Answer

It creates a compressed JSON index that provides the AI with a map of the entire project, allowing it to stay informed about the overall structure without loading every file into the context window at once.

Question 3

Where is the codebase index stored?

Accepted Answer

The index is saved locally in your project root at .ralph/codebase_index.json, making it easy for the agent to reference quickly.

Question 4

Does this work with any programming language?

Accepted Answer

Yes, the sub-agent is instructed to identify source files and extract exports and purpose regardless of the specific programming language used.

Question 5

What happens if my project has over 50 files?

Accepted Answer

This skill is specifically designed for that scenario. It uses a 'Deep Dive' strategy to query the index and only read the most relevant files required for your specific task.

Deep Codebase Navigator

Key Features

Use Cases

Deep Codebase Navigator

Key Features

Use Cases