CodeGuard has 16 tools with schemas and descriptions present, but quality is inconsistent. Tool names follow verb_noun convention (load_project, query_callers, search_functions), which is good. However, descriptions are often vague or lack actionable context. Many parameters lack type information in visible schemas, e.g., 'limit' in search_functions shows type 'integer' but no min/max bounds. Output schemas are not documented anywhere in the source. Error handling is absent, no guidance on what to do if a project fails to load or a function is not found. The 'ask' tool (tool 14) is particularly problematic: it accepts free-form natural language with no constraints, making it difficult for LLMs to know when to invoke it vs. structured query tools. Parameter descriptions are present but generic (e.g., 'project路径（缺省用最近加载的项目）' repeats across 10+ tools without explaining dependencies or failure modes). No evidence of pagination support despite tools like search_functions and query_callers that could return large result sets.

• Document output schemas for all tools. For search_functions, specify: returns array of {name: string, file: string, line: number, type: 'function'|'method'}. For query_callers, return {caller_name, caller_file, caller_line, call_line}.
• Add pagination to search_functions, query_callers, query_callees. Accept offset/limit or cursor. Return total_count and next_cursor so LLMs can iterate without re-querying.
• Add error recovery hints to descriptions. E.g., query_callers: 'If function not found, try search_functions(keyword) first to find the exact name.' diff_versions: 'If git ref invalid, returns error with available refs.'
• Constrain the 'ask' tool. Add enum or pattern to guide LLM selection. E.g., 'Use for high-level questions ("What is the login flow?"). For specific queries, use query_callers, search_functions, or analyze_impact instead.'
• Enrich parameter descriptions with context. Instead of 'project路径（缺省用最近加载的项目）', write: 'Project path (absolute or relative). If omitted, uses the most recently loaded project. Call list_projects() to see available projects.'