// Answer questions using the Arkon knowledge base. Searches wiki first, drills into raw sources only when needed. Supports quick, standard, and deep modes. Triggers on: what do we know about, find in KB, look up, query:, arkon query, search the wiki, tell me about, based on the KB.
Propose or directly apply edits to Arkon wiki pages, including proposing brand new pages. Contributors create drafts for review; editors/admins can edit/create directly. Triggers on: update wiki, fix this page, propose edit, edit wiki page, correct the KB, improve wiki, resubmit my draft, withdraw my draft, create new wiki page, propose new page.
Review, approve, request changes on, or reject pending wiki edit drafts in Arkon. Requires editor or admin role. Triggers on: review drafts, pending reviews, check draft queue, approve draft, reject draft, request changes, send draft back, review wiki changes.
| name | arkon-query |
| description | Answer questions using the Arkon knowledge base. Searches wiki first, drills into raw sources only when needed. Supports quick, standard, and deep modes. Triggers on: what do we know about, find in KB, look up, query:, arkon query, search the wiki, tell me about, based on the KB. |
| allowed-tools | mcp__arkon__search_wiki mcp__arkon__read_wiki_index mcp__arkon__read_wiki_page mcp__arkon__list_wiki_pages mcp__arkon__list_knowledge_types mcp__arkon__get_knowledge_type_docs mcp__arkon__list_sources mcp__arkon__get_source mcp__arkon__get_source_outline mcp__arkon__get_source_pages |
The wiki has already done the synthesis work. Read strategically, answer precisely. Raw sources are a fallback — not the first stop.
| Mode | Trigger | Tools used | Best for |
|---|---|---|---|
| Quick | query quick: ... or simple factual Q | search_wiki only | Direct lookups, names, dates |
| Standard | default | search_wiki → 2-4 pages | Most questions |
| Deep | query deep: ... or "thorough", "find everything" | Full wiki traverse + source drill-down | Cross-cutting synthesis |
search_wiki(query, top_k=5). If the top result has high similarity (≥ 80%) and its summary answers the question, respond immediately.read_wiki_page(slug) for the top 1-2 results.Do not call read_wiki_index or source tools in quick mode.
search_wiki(query) — ranked list of pages. Read summaries.read_wiki_page(slug) for the 2-4 most relevant results. Follow wikilinks [[slug]] at depth 1 only if they look essential.concept/onboarding).search_wiki + read_wiki_index to map coverage.Use when: the wiki has paraphrased something and you need the exact wording, or the user asks "what does the document actually say."
list_sources(knowledge_type=...) → find source IDs by category
get_source(source_id) → check metadata and page count
get_source_outline(source_id) → find the right section (TOC)
get_source_pages(source_id, "5-7") → read exact pages
Do not call get_source_pages without first checking get_source_outline on documents > 10 pages.
When the user asks "what's in the X category" or wants to explore a knowledge type:
list_knowledge_types() → see all categories + doc counts
get_knowledge_type_docs(slug) → docs in that category
list_wiki_pages(knowledge_type=slug) → wiki pages tagged to that category
| Start with | When to stop |
|---|---|
search_wiki | If summary has the answer |
| 2-4 wiki pages | Usually sufficient for standard queries |
get_source_outline | Before reading pages of a long source |
get_source_pages | Read only the specific pages needed |
Never read more than 6 wiki pages for a standard query. For deep mode, cap at 15 unless the question explicitly demands full coverage.
search_wiki, read_wiki_page, and list_wiki_pages automatically filter to your allowed types.list_sources and get_source_pages enforce per-source scope.