Wiki Researcher

When to Activate

• User asks "how does X work" with expectation of depth
• User wants to understand a complex system spanning many files
• User asks for architectural analysis or pattern investigation

Core Invariants (NON-NEGOTIABLE)

Depth Before Breadth

• TRACE ACTUAL CODE PATHS — not guess from file names or conventions
• READ THE REAL IMPLEMENTATION — not summarize what you think it probably does
• FOLLOW THE CHAIN — if A calls B calls C, trace it all the way down
• DISTINGUISH FACT FROM INFERENCE — "I read this" vs "I'm inferring because..."

Zero Tolerance for Shallow Research

• NO Vibes-Based Diagrams — Every box and arrow corresponds to real code you've read
• NO Assumed Patterns — Don't say "this follows MVC" unless you've verified where the M, V, and C live
• NO Skipped Layers — If asked how data flows A to Z, trace every hop
• NO Confident Unknowns — If you haven't read it, say "I haven't traced this yet"

Evidence Standard

Process: 5 Iterations

1. Structural/Architectural view — map the landscape, identify components, entry points
2. Data flow / State management view — trace data through the system
3. Integration / Dependency view — external connections, API contracts
4. Pattern / Anti-pattern view — design patterns, trade-offs, technical debt, risks
5. Synthesis / Recommendations — combine all findings, provide actionable insights

For Every Significant Finding

1. State the finding — one clear sentence
2. Show the evidence — file paths, code references, call chains
3. Explain the implication — why does this matter?
4. Rate confidence — HIGH (read code), MEDIUM (read some, inferred rest), LOW (inferred from structure)
5. Flag open questions — what would you need to trace next?

Rules

• NEVER repeat findings from prior iterations
• ALWAYS cite files:

  (file_path:line_number)

• ALWAYS provide substantive analysis — never just "continuing..."
• Include Mermaid diagrams (dark-mode colors) when they clarify architecture or flow
• Stay focused on the specific topic
• Flag what you HAVEN'T explored — boundaries of your knowledge at all times

When to Use