deep-research

Core Research Pipeline

• 8.5-Phase Research Pipeline: Scope → Plan → Retrieve (Parallel) → Triangulate → Outline Refinement → Synthesize → Critique → Refine → Package
• Multiple Research Modes: Quick, Standard, Deep, and UltraDeep
• Graph-of-Thoughts Reasoning: Non-linear exploration with branching thought paths

2025 Enhancements (Latest - v2.2)

• 🔄 Auto-Continuation System (NEW): TRUE UNLIMITED length (50K, 100K+ words) via recursive agent spawning with context preservation
• 📄 Progressive File Assembly: Section-by-section generation with quality safeguards
• ⚡ Parallel Search Execution: 5-10 concurrent searches + parallel agents (3-5x faster Phase 3)
• 🎯 First Finish Search (FFS) Pattern: Adaptive completion based on quality thresholds
• 🔍 Enhanced Citation Validation (CiteGuard): Hallucination detection, URL verification, multi-source cross-checking
• 📋 Dynamic Outline Evolution (WebWeaver): Adapt structure after Phase 4 based on evidence
• 🔗 Attribution Gradients UI: Interactive citation tooltips showing evidence chains in HTML reports
• 🛡️ Anti-Fatigue Enforcement: Prose-first quality checks prevent bullet-point degradation

Traditional Strengths

• Citation Management: Automatic source tracking and bibliography generation
• Source Credibility Assessment: Evaluates source quality and potential biases
• Structured Reports: Professional markdown, HTML (McKinsey-style), and PDF outputs
• Verification & Triangulation: Cross-references claims across multiple sources

The skill is already installed globally in ~/.claude/skills/deep-research/

No additional dependencies required for basic usage.

In Claude Code

Simply invoke the skill:

```

Use deep research to analyze the state of quantum computing in 2025

```

Or specify a mode:

```

Use deep research in ultradeep mode to compare PostgreSQL vs Supabase

```

Direct CLI Usage

```bash

# Standard research

python ~/.claude/skills/deep-research/research_engine.py --query "Your research question" --mode standard

# Deep research (all 8 phases)

python ~/.claude/skills/deep-research/research_engine.py --query "Your research question" --mode deep

# Quick research (3 phases only)

python ~/.claude/skills/deep-research/research_engine.py --query "Your research question" --mode quick

# Ultra-deep research (extended iterations)

python ~/.claude/skills/deep-research/research_engine.py --query "Your research question" --mode ultradeep

```

| Mode | Phases | Duration | Best For |

|------|--------|----------|----------|

| Quick | 3 phases | 2-5 min | Simple topics, initial exploration |

| Standard | 6 phases | 5-10 min | Most research questions |

| Deep | 8 phases | 10-20 min | Complex topics requiring thorough analysis |

| UltraDeep | 8+ phases | 20-45 min | Critical decisions, comprehensive reports |

Research reports are saved to organized folders in ~/Documents/[Topic]_Research_[Date]/

Each report includes:

• Executive Summary
• Detailed Analysis with Citations
• Synthesis & Insights
• Limitations & Caveats
• Recommendations
• Full Bibliography
• Methodology Appendix

Unlimited Report Generation (2025 Auto-Continuation System)

Reports use progressive file assembly with auto-continuation - achieving truly unlimited length through recursive agent spawning:

How It Works:

1. Initial Generation (18K words)

- Generate sections 1-10 progressively

- Each section written to file immediately (stays under 32K limit per agent)

- Save continuation state with research context

1. Auto-Continuation (if needed)

- Automatically spawns continuation agent via Task tool

- Continuation agent loads state: themes, narrative a