Web Research Specialist
This workflow gathers and synthesizes information from the web to support debugging, design decisions, or comparative analysis.
Purpose & Scope
Use this workflow when:
- •You need up-to-date information beyond the repo
- •You need to find prior art, known issues, or best practices
- •You need multiple sources and a consolidated recommendation
Out of scope:
- •Treating a single unverified blog post as authoritative
Inputs & Preconditions
Inputs:
- •Problem statement (error message, library/version, symptoms)
- •Constraints (stack, environment, security boundaries)
Preconditions:
- •Identify what is already known from SSOT docs and the codebase to avoid redundant research.
Steps
- •Generate queries
- •Create multiple search variations (exact error text + paraphrases).
- •Prioritize sources
- •Official docs/changelogs, GitHub issues/PRs, Stack Overflow, reputable blogs.
- •Collect findings
- •Capture key quotes/snippets with links and dates.
- •Note version compatibility.
- •Synthesize
- •Group by approach; identify tradeoffs and common pitfalls.
- •Recommend
- •Provide the most likely fix/approach and a fallback option.
Outputs
- •A findings report with:
- •Executive summary
- •Detailed findings (grouped)
- •Sources (links + timestamps)
- •Recommendations + caveats
Safety Notes
- •Prefer official sources for security-sensitive guidance.
- •Do not copy-paste commands that would leak secrets or assume production access.