janjaszczak deep-research
Activation gate (anti-noise)
Run only if at least one is true:
- User explicitly requests research/verification or provides external links.
- Topic is time-sensitive (prices, laws, tooling versions, security, vendor docs).
- You detect >10% risk of outdated knowledge. Otherwise: answer normally (no research ritual).
Research protocol
1) Frame
- Restate the question as a falsifiable query.
- Define “freshness window” (e.g., last 3–6 months) unless user asks historical.
- Define acceptance criteria for sources (primary docs preferred).
2) Collect sources
- Prefer: official docs, primary specs, reputable engineering blogs, vendor changelogs.
- For each key claim, capture at least one authoritative source.
- If sources disagree: represent both and explain implications.
Tool hierarchy (cost-aware):
- Named library/framework API docs (version-aware):
context7MCP + skillmcp-context7-docs— not general web search. - Default:
searxngMCP (self-hosted, free) orduckduckgoMCP (free) for routine lookups and freshness checks — the agent synthesizes results itself. - Escalate to
perplexityMCP only when the user explicitly asks for "deep research"/"zweryfikuj dokładnie", or the query is high-stakes and a single-call synthesized answer with citations justifies the per-request cost. - Cursor-bundled
parallel-deep-research/parallel-web-searchskills only when the user explicitly says "deep"/"exhaustive"/"comprehensive report" (see that skill's own activation gate) — these are the most expensive option.
3) Extract & normalize
- Extract only what is needed to answer.
- Keep notes in a compact “evidence table” (claim → source → date).
4) Synthesize
Produce one of:
- Research brief (short, decision-oriented)
- Decision memo (trade-offs + recommendation)
- Implementation notes (steps + verification commands)
5) Verification hooks (optional)
If the environment allows:
- Provide 1–3 concrete commands/tests to verify claims locally.
- For Cursor, prefer commands that are fast and deterministic.
Optional: store memo to MCP memory
If the user says “zapisz”:
- Store: question, key findings, chosen decision, links, and date.
Output contract
- Lead with recommendation.
- Then evidence-backed reasoning (citations).
- End with “how to verify quickly”.
Failure handling
If web/tools not available:
- Mark claims as UNCERTAIN.
- Provide the shortest verification path (exact query + official doc location).