LearnNewsExamplesServices
Frontmatter
id9180
titlePromote ask_knowledge_base as RAG Sub-Agent in AGENTS_STARTUP.md
stateClosed
labels
documentationenhancementai
assigneestobiu
createdAtFeb 16, 2026, 3:42 AM
updatedAtFeb 16, 2026, 3:45 AM
githubUrlhttps://github.com/neomjs/neo/issues/9180
authortobiu
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtFeb 16, 2026, 3:45 AM

Promote ask_knowledge_base as RAG Sub-Agent in AGENTS_STARTUP.md

Closed v12.0.0 documentationenhancementai
tobiu
tobiu commented on Feb 16, 2026, 3:42 AM

We need to update AGENTS_STARTUP.md to explicitly promote the ask_knowledge_base tool as a RAG Sub-Agent.

Problem: Agents (including Gemini) often rely on outdated training data for framework-specific syntax (e.g., State Provider bindings, Config system), leading to "hallucinated" legacy code. They underestimate the power of ask_knowledge_base, viewing it as a simple search rather than a grounded expert.

Solution: Refactor AGENTS_STARTUP.md to include a new "Ask the Expert" Protocol.

  1. Rebrand the Tool: Explicitly define ask_knowledge_base as an "Embedded RAG Sub-Agent" that has read-access to the current repository state.
  2. Mandate Usage for Syntax: Enforce a rule that agents MUST use this tool when generating code for core framework features (Bindings, Configs, Workers, VDOM) to verify current syntax.
  3. Explain the "Why": Highlight that this tool performs a "Read-Eval-Generate" loop: it retrieves relevant files, reads their full content, and synthesizes an answer based only on the current codebase, making it the single source of truth for syntax.
  4. Provide Examples: Show concrete queries like:
    • ask_knowledge_base(query='current syntax for state provider bindings')
    • ask_knowledge_base(query='how to implement a reactive config')

This will shift agent behavior from "guessing based on training" to "verifying against the repo".

tobiu added the documentation label on Feb 16, 2026, 3:42 AM
tobiu added the enhancement label on Feb 16, 2026, 3:42 AM
tobiu added the ai label on Feb 16, 2026, 3:42 AM
tobiu
tobiu Feb 16, 2026, 3:44 AM

Input from Gemini 3 Pro:

✦ I have updated AGENTS_STARTUP.md to include the "Ask the Expert" Protocol.

This new section (3.4) explicitly mandates the use of ask_knowledge_base as a RAG Sub-Agent for verifying syntax before writing code, specifically targeting "hallucination hazards" like outdated binding syntax.

The documentation now clearly defines the tool's role as the single source of truth for framework patterns.

tobiu assigned to @tobiu on Feb 16, 2026, 3:44 AM
tobiu closed this issue on Feb 16, 2026, 3:45 AM
tobiu referenced in commit 6f9a2e0 - "docs: Add 'Ask the Expert' Protocol to AGENTS_STARTUP.md (#9180)" on Feb 16, 2026, 3:45 AM