wiki-enrich

Wiki Enrich — Add External Context from the Web

Search the web for documentation, best practices, and relevant articles, then write them as Serena wiki memories. Connects internal codebase knowledge with the broader ecosystem.

CRITICAL: Serena is REQUIRED

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"

Prerequisites

Use mcp__plugin_serena_serena__read_memory with memory_name: "wiki/schema". If it doesn't exist, tell the user to run wiki-setup first.

Determine Enrichment Targets

If user specifies a topic

Enrich exactly what they asked for.

If user asks for broad enrichment

1. Use mcp__plugin_serena_serena__read_memory on wiki/overview to identify the tech stack
2. Propose enrichment targets based on technologies used
3. Let the user pick which topics to enrich
4. Check mcp__plugin_serena_serena__list_memories with topic: "wiki/external" to avoid duplicates

Research Process

For each enrichment target:

1. Search the web

Use WebSearch for:

• Official documentation (highest priority)
• Well-regarded guides and best practices
• Architecture references

2. Fetch and synthesize

Use WebFetch on the best sources (1-3 per topic). Synthesize — don't copy verbatim.

3. Connect to internal knowledge

Use mcp__plugin_serena_serena__read_memory on related internal wiki pages. Use mcp__plugin_serena_serena__get_symbols_overview to verify which modules actually use the technology. This makes the "Relevance" section accurate.

Write External Pages

Use mcp__plugin_serena_serena__write_memory with memory_name: "wiki/external/{topic-slug}":

# [Topic Title]

> **Category**: external
> **Created**: YYYY-MM-DD
> **Updated**: YYYY-MM-DD
> **Status**: active

## Summary
[What this covers and why it's relevant]

## Source
- **URL**: [primary source URL]
- **Retrieved**: YYYY-MM-DD
- **Type**: official docs | guide | article

## Key Takeaways
1. [Most important point for this project]
2. [Second point]
3. [Third point]

## Relevance to This Project
[How this connects to the codebase. Reference internal wiki pages by memory name:
"Our wiki/modules/auth module uses [pattern] which aligns with..."]

## Detailed Notes
[Synthesized summary organized by subtopic]

## Related Pages
- wiki/{category}/{name} — connection
- wiki/{category}/{name} — connection

## Sources
- [URL] — [contribution]

After Creating Pages

Update bidirectional references

Use mcp__plugin_serena_serena__edit_memory on internal pages referenced in the new external page — add a reference back to the external page in their Related Pages section.

Update wiki/index

Use mcp__plugin_serena_serena__edit_memory on wiki/index to add new entries under the ## External section.

Append to wiki/log

Use mcp__plugin_serena_serena__edit_memory on wiki/log (mode: "regex", needle: \Z):

## [YYYY-MM-DD HH:MM] ENRICH | [description]
- Created: [list of new external pages]
- Topics: [what was researched]
- Connected to: [N internal wiki pages linked]

Inform the user

Report what was created, what internal pages were connected, any surprising findings.

Serena Tools Reference

All prefixed mcp__plugin_serena_serena__:

Operation	Tool
Read wiki page	read_memory
Write wiki page	write_memory
Update wiki page	edit_memory
Browse wiki	list_memories (topic: "wiki/external")
Get module symbols	get_symbols_overview
Search codebase	search_for_pattern
Read source file	read_file

Web tools (not Serena):

• WebSearch — find documentation
• WebFetch — retrieve page content