Repository Search

Retrieve and verify context; do not own planning, diagnosis, or implementation decisions.

Modes

Mode	Scope
default	Narrowest search that answers the question
--code	Code, symbols, references, and call paths
--doc	Project documents, decisions, and requirements
--deep	Reconcile code with documents and report conflicts
--impact	Callers, dependencies, affected modules, and workflows

Search Order

Use the first level that yields sufficient evidence:

1. mind_mcp for project knowledge and documents.
2. graph_mcp.semantic_search for semantic code discovery and relationships.
3. serena for symbols, implementations, references, and structural search.
4. rg for exact-string filesystem search.

If a tool is unavailable, record it once and continue without retrying. Stop descending when evidence is sufficient; use lower levels only to close a specific gap. If all levels fail, ask the user for context.

Workflow

1. Reuse a confirmed project; otherwise discover and activate it once.
2. Search narrowly. Treat semantic matches as candidates, not proof.
3. Verify important claims with direct code, symbol relationships, call paths, or document passages.
4. Trace only relationships required by the question; cap depth and result count.
5. Return an Evidence Bundle. Never fabricate missing context.

Evidence is sufficient when it identifies the relevant source, supports required relationships, separates facts from inference, and exposes conflicts or gaps.

Evidence Bundle

Include only relevant sections:

## Coverage
- tool: used | unavailable | no results | skipped

## Findings
- Claim — code|document — file+symbol|source_id+paragraph_id — confidence
  Evidence: concise supporting detail

## Relationships
Verified call paths, dependencies, or document relations.

## Contradictions
Conflicting sources or code-document differences.

## Inferences
Derived conclusions, explicitly labeled.

## Gaps
Unavailable, unindexed, or unanswered context.

Subagents

Do not spawn by default. Use at most two investigators—code and documents—only when the user or project instructions permit delegation and the work has independent tracks, spans at least three subsystems, or needs independent conflict verification. The main agent owns synthesis and confidence.

Tool References

Read only when exact parameters are needed:

• Code Graph MCP
• Document Graph RAG