wiki-query

Wiki Query — Search and Answer from the Wiki

Answer questions by consulting the wiki (stored as Serena memories) first, then the code if needed. The wiki exists so you don't rediscover knowledge from scratch every session.

CRITICAL: Serena is REQUIRED

The wiki lives in Serena memories. All read operations use Serena.

If Serena is NOT available — STOP. Tell the user:

"Serena is required — the wiki is stored as Serena memories. Install it: /plugin install serena@claude-plugins-official"

Process

Step 1: Read the index

Use mcp__plugin_serena_serena__read_memory with memory_name: "wiki/index".

If it doesn't exist, tell the user: "No wiki found. Run wiki-setup to create one."

Step 2: Find relevant pages

Match the user's question against the index entries:

• Keyword matches in page names and summaries
• Category relevance: architecture for "how does X work", decisions for "why X", modules for "what does module X do"
• Identify 1-5 relevant wiki memory names

Step 3: Read relevant wiki memories

Use mcp__plugin_serena_serena__read_memory for each relevant page. Start with the most likely match. Stop if the first page fully answers the question.

Step 4: Synthesize an answer

Compose an answer from the wiki content:

• Cite sources: "According to the wiki/architecture/system-design page..."
• Be specific: include file paths, symbol names, concrete details
• Acknowledge gaps: say what's covered and what's missing

Step 5: Fill gaps from code (if needed)

If the wiki doesn't fully answer the question:

1. Tell the user: "The wiki doesn't have complete information. Let me check the code."
2. Use Serena's code analysis tools:
   • mcp__plugin_serena_serena__find_symbol — locate the symbol in question
   • mcp__plugin_serena_serena__get_symbols_overview — understand module contents
   • mcp__plugin_serena_serena__find_referencing_symbols — trace dependencies
   • mcp__plugin_serena_serena__search_for_pattern — find patterns
   • mcp__plugin_serena_serena__read_file — read source files
3. Answer the question
4. Suggest updating the wiki: "This information isn't in the wiki yet. Say 'update the wiki' to capture it."

Step 6: Optionally file the answer

If the answer reveals significant knowledge that should persist:

• Ask: "Would you like me to add this to the wiki?"
• If yes, use mcp__plugin_serena_serena__write_memory to create a new wiki page, then update wiki/index and wiki/log via edit_memory

Answer Format

**Answer** (from wiki)

[Synthesized answer citing wiki memory names]

**Wiki pages consulted:**
- wiki/{category}/{name}
- wiki/{category}/{name}

[If gaps found:]
**Note:** The wiki doesn't cover [gap]. Run wiki-update to add this.

Special Queries

Query	Action
"What's in the wiki?"	read_memory wiki/index, summarize
"What changed recently?"	read_memory wiki/log, show last 10 entries
"Is the wiki up to date?"	Suggest wiki-lint
"Show me [page]"	read_memory wiki/{matching page}
"Browse the wiki"	list_memories topic: "wiki"

Serena Tools Reference

All prefixed mcp__plugin_serena_serena__:

Operation	Tool
Read wiki page	read_memory
Browse wiki	list_memories (topic: "wiki")
Search wiki content	search_for_pattern
Find symbols in code	find_symbol
Get module overview	get_symbols_overview
Trace dependencies	find_referencing_symbols
Read source file	read_file
Write new wiki page	write_memory
Update wiki page	edit_memory