version: "1.0.1" name: wigolo-research description: | Local-first multi-step research with question decomposition, parallel search, structured briefs, cross-references, and gap analysis. Use when the user needs comprehensive analysis, comparison reports, literature reviews, or says "research", "compare X vs Y", "deep dive", "thorough analysis", "find everything about". Returns a structured brief with topics, highlights, key_findings, sections.overview.cross_references, sections.comparison, sections.gaps. license: AGPL-3.0-only metadata: author: KnockOutEZ version: 0.3.0 homepage: https://github.com/KnockOutEZ/wigolo repository: https://github.com/KnockOutEZ/wigolo

wigolo research

Comprehensive multi-source research with structured output. Beats chaining search + fetch manually for multi-source synthesis.

Quick Reference

// Standard research
{ "question": "How does Deno 2 compare to Node.js for production?", "depth": "standard" }
// Comprehensive (more sources, deeper analysis)
{ "question": "SQLite vs PostgreSQL vs DuckDB for analytics", "depth": "comprehensive" }
// Quick factual check
{ "question": "What are the breaking changes in React 19?", "depth": "quick" }
// Domain-scoped research
{ "question": "Next.js App Router patterns", "depth": "standard", "include_domains": ["nextjs.org", "vercel.com"] }
// With structured output schema
{ "question": "Compare Prisma vs Drizzle vs TypeORM", "depth": "standard", "schema": { "type": "object", "properties": { "orm": { "type": "string" }, "bundle_size": { "type": "string" }, "type_safety": { "type": "string" } } } }

Depth Levels

Override the source count for the chosen depth with max_sources (cap 50) — raise it to widen coverage, lower it to keep a run fast.

Output: Structured Brief

When MCP sampling is unavailable (common case), the output carries a brief:

{
  "brief": {
    "key_findings": [...],       // top passages across all sources — start report here
    "topics": [...],             // sources grouped by sub-query
    "sections": {
      "overview": { "cross_references": [...] },  // findings corroborated by 2+ sources — most reliable
      "comparison": {...},                         // entity-specific points for X vs Y queries
      "gaps": [...]                                // sub-queries / named entities with limited coverage
    }
  },
  "sub_queries": [...],
  "sources": [...],
  "query_type": "..."          // decomposition strategy used
}

Gaps surface named sub-entities that decomposition or search could not corroborate — never silently dropped.

Writing the Report

See wigolo/rules/synthesis.md. Quick version:

1. Start with key_findings for the executive summary.
2. Use sections.overview.cross_references for the most reliable claims.
3. Write sections from topics.
4. Build comparison table from sections.comparison (if present).
5. Note sections.gaps as limitations.
6. Cite with [N] format from citations.

Anti-Patterns

• DON'T use for single-URL lookups — use fetch instead.
• DON'T use for data gathering — use agent with a schema instead.
• DON'T pre-probe cache before calling research — it checks internally.

When NOT to use wigolo-research

• You want a single-shot search result, not a synthesized report — use search with format: "answer".

See Also

• wigolo-search — for single-query search
• wigolo-agent — for structured data gathering (not reports)
• wigolo/rules/synthesis.md — how to write from briefs