wiki-lint

Wiki Lint — Health Check and Maintenance

Audit the wiki (stored as Serena memories) for structural issues, staleness, and quality. All checks read from Serena, all fixes write to Serena.

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.

Checks

1. Structural Integrity

List all wiki memories: Use mcp__plugin_serena_serena__list_memories with topic: "wiki" to get every wiki memory.

Index completeness:

• Use mcp__plugin_serena_serena__read_memory on wiki/index
• For each memory found by list_memories, verify it has an entry in the index
• For each index entry, verify the memory exists
• Flag: orphan memories (not in index), broken entries (in index but memory missing)

Required sections:

• Use mcp__plugin_serena_serena__read_memory on each wiki page
• Verify each has: Category, Created, Updated, Status metadata
• Verify each has: Summary, Related Pages, Sources sections
• Flag: pages with missing sections

2. Cross-Reference Integrity

Bidirectional references:

• For each page, extract all wiki/{category}/{name} references in Related Pages
• Use mcp__plugin_serena_serena__read_memory on referenced pages
• Verify the referenced page links back
• Flag: missing bidirectional references

3. Staleness Detection

For each wiki page:

1. Read the Sources section to get referenced file paths
2. Use Bash git log -1 --format="%ai" -- <filepath> for each source file's last-modified date
3. Compare against the page's Updated date
4. Flag as stale if sources are newer

Severity:

• Mild (< 7 days stale): minor update needed
• Moderate (7-30 days): significantly outdated
• Severe (> 30 days): likely inaccurate

4. Content Quality

• Empty sections: headers with no content below them
• Stubs: pages under 100 words of content
• Deprecated but referenced: pages with Status: deprecated still in Related Pages of active pages
• Placeholders: search for TBD, TODO, FIXME, [placeholder]

5. Coverage Analysis

Use mcp__plugin_serena_serena__list_dir to find all source directories. Check which have corresponding wiki/modules/{name} pages. Flag undocumented modules.

Health Report

## Wiki Health Report

**Scan date**: YYYY-MM-DD
**Total pages**: N

### Summary

| Metric | Count | Status |
|--------|-------|--------|
| Healthy pages | N | OK |
| Stale pages | N | [WARN/OK] |
| Orphan memories | N | [WARN/OK] |
| Missing cross-refs | N | [WARN/OK] |
| Empty sections | N | [WARN/OK] |
| Stub pages | N | [WARN/OK] |
| Undocumented modules | N | [INFO/OK] |

### Health Score: N/10

### Issues Found

#### Critical
1. [Issue] — [fix]

#### Warnings
1. [Issue] — [fix]

#### Info
1. [Issue] — [fix]

Auto-Fix

Offer to fix mechanical issues using Serena:

Can auto-fix (via edit_memory and write_memory):

• Add orphan memories to wiki/index
• Add missing bidirectional references
• Update "Last rebuilt" date in wiki/index

Cannot auto-fix (require wiki-update):

• Stale page content
• Empty sections needing real content
• Placeholder text

Ask: "I can auto-fix N mechanical issues. Should I proceed?"

If yes, fix via mcp__plugin_serena_serena__edit_memory, then append to wiki/log.

Serena Tools Reference

All prefixed mcp__plugin_serena_serena__:

Operation	Tool
List all wiki pages	list_memories (topic: "wiki")
Read wiki page	read_memory
Update wiki page	edit_memory
List source dirs	list_dir
Get module symbols	get_symbols_overview