Semantic search for best practices across all guides or within a specific guide.

Use this tool when:

• The user asks a conceptual question: "How to hash passwords?"

• You need to find code patterns or recommendations

• You want to deep dive into a specific guide (provide guide_id)

IMPORTANT: Always formulate queries in English for optimal search quality, even if the user's question is in another language.

Args: query: Natural language search query in English. Be specific and descriptive. guide_id: Optional guide ID to search within (e.g., 'python/django-security'). If provided, searches only within this guide (returns top 3 sections). If not provided, searches across all guides (returns top 5 results). namespace: Filter by technology (e.g., 'python', 'go'). Ignored if guide_id is set.

Returns: Relevant chunks with content and source information

Find guides that match a task description.

Use this tool when:

• You need to find the right guide for a specific task

• The user describes a problem or goal

• You want guide-level results, not chunk-level

IMPORTANT: Always formulate queries in English for optimal search quality, even if the user's question is in another language.

Args: query: Description of the task or goal in English namespace: Filter by technology

Returns: Top 3 matching guides with descriptions

Get the complete content of a guide.

Use this tool when:

• You need the full context of a guide

• The guide is short and you want everything

• You're implementing a feature from scratch

Warning: Large guides (>20k chars) will be truncated. Use consult_guide_for_task for specific sections.

Args: guide_id: Guide ID (e.g., 'python/fastapi-production')

Returns: Full guide content or table of contents if truncated