This ticket is part of Epic #7668 and depends on the completion of #7669.
Once the query_documents tool is self-documenting via its OpenAPI specification, we must refactor AGENTS.md to remove the redundant documentation.
Changes Required
Remove Detailed Sections: Delete the following sections from AGENTS.md under Section 3, "The Knowledge Base: Your Primary Source of Truth":
- "How to Interpret Query Results"
- All query strategy subsections ("Strategy for High-Level Conceptual Questions", "Discovery Pattern", "Targeted Content-Type Searching")
- "When Queries Fail to Find Information"
Replace with a Pointer: Replace the removed content with a concise pointer to the tool's own documentation. The new section should look like this:
### The Query Command
Your most important tool is the local AI knowledge base. To use it, call the `query_documents` tool.
**Critical**: The `query_documents` tool is self-documenting. Read its description carefully for:
- How to interpret results
- Query strategies for different scenarios
- Content type filtering
- Handling edge cases
The tool contains complete guidance on effective querying. Follow its documented patterns.
This change will significantly shorten AGENTS.md and ensure that the tool's documentation is the single source of truth.
This ticket is part of Epic #7668 and depends on the completion of #7669.
Once the
query_documentstool is self-documenting via its OpenAPI specification, we must refactorAGENTS.mdto remove the redundant documentation.Changes Required
Remove Detailed Sections: Delete the following sections from
AGENTS.mdunder Section 3, "The Knowledge Base: Your Primary Source of Truth":Replace with a Pointer: Replace the removed content with a concise pointer to the tool's own documentation. The new section should look like this:
### The Query Command Your most important tool is the local AI knowledge base. To use it, call the `query_documents` tool. **Critical**: The `query_documents` tool is self-documenting. Read its description carefully for: - How to interpret results - Query strategies for different scenarios - Content type filtering - Handling edge cases The tool contains complete guidance on effective querying. Follow its documented patterns.This change will significantly shorten
AGENTS.mdand ensure that the tool's documentation is the single source of truth.