research-first

Plan research by searching documentation and tracing code to root cause.

437|45|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/zaxbysauce/opencode-swarm --skill research-first-zaxbysauce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-first
Source: https://github.com/zaxbysauce/opencode-swarm/tree/main/.claude/skills/research-first
Command: npx skills add https://github.com/zaxbysauce/opencode-swarm --skill research-first-zaxbysauce

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan research before coding fixes, investigate technical debt, architect solutions, or diagnose unknown issues by systematically searching current official documentation and state-of-the-art approaches before tracing code.

Core Features & Use Cases

  • Online documentation research: quickly locate current guidance and best practices to inform decisions.
  • Parallel evidence gathering: deploy multiple sub-agents to explore sources simultaneously and synthesize findings.
  • End-to-end root-cause tracing: verify issues by tracing from symptoms to source code and reaching ≥95% confidence before proposing changes.

Quick Start

Analyze a reported issue by first searching official docs and literature, then trace the root cause through the codebase.

Frequently Asked Questions about research-first

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace the root cause of an issue through source code before proposing fixes?

Root-cause tracing requires verifying issues by searching current documentation and tracing problems end-to-end through actual source code to reach ≥95% confidence before proposing changes. This approach prevents fixing symptoms instead of underlying faults.

What is the best way to research state-of-the-art approaches before diagnosing unknown technical issues?

Researching state-of-the-art approaches involves deploying parallel sub-agents to gather diverse evidence across multiple online sources simultaneously. This synthesizes current official documentation and best practices to inform technical decisions and architecture.

How do I plan research before coding fixes for technical debt?

Plan research before coding fixes by systematically searching official documentation and literature first, then tracing the reported issue through the codebase. This ensures fixes are grounded in current guidance rather than assumptions.

Can I use parallel sub-agents to gather evidence for issue diagnosis?

Yes, parallel sub-agents can be deployed to explore multiple sources simultaneously during issue diagnosis. They gather diverse evidence and synthesize findings to validate root-cause tracing before you implement any code changes.

When do I need to search official documentation instead of immediately modifying source code?

You need to search official documentation whenever investigating technical debt, architecting solutions, or diagnosing unknown issues. Validating findings against current guidance before tracing code paths prevents implementing outdated or incorrect fixes.

Why does my code fix keep failing to address the actual root cause of the problem?

Code fixes fail when they target symptoms instead of the root cause. Achieving ≥95% confidence through end-to-end source code tracing and validating findings against current documentation ensures the actual fault is addressed.