English | [ํ๊ตญ์ด](README.ko.md) | [ไธญๆ](README.zh.md) | [ๆฅๆฌ่ช](README.ja.md) | [Espaรฑol](README.es.md)
# insane-research
<div align="center">
<img src="assets/hero.png" width="860" alt="insane-research cinematic hero">
</div>
> **insane-research โ AI-powered multi-agent deep research with source verification and structured outputs.**
Turn a single question into a comprehensive, citation-backed research report โ automatically.
[Quick Start](#quick-start) โข [Why insane-research?](#why-insane-research) โข [How it works](#how-it-works) โข [Commands](#commands) โข [Output](#output-structure) โข [Requirements](#requirements)
---
## Quick Start
### 1. Add the marketplace (once)
```
/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
```
### 2. Install the plugin
```
/plugin install insane-research
```
### 3. Restart Claude Code
Cache loads on startup โ a restart is required after install.
### 4. Start researching
```
/insane-research AI coding assistants productivity impact
```
Claude will ask a few scoping questions, then deploy parallel research agents and deliver a structured report.
---
## Why insane-research?
- **Parallel agents, not sequential searches** โ 3-5 agents run simultaneously across web, academic, and technical sources, cutting research time significantly
- **Source quality ratings (AโE)** โ Every source is graded from peer-reviewed papers (A) to speculative posts (E), so you always know what you're reading
- **Hallucination-resistant** โ Every factual claim requires an inline citation; key claims are cross-verified against at least 2 independent sources
- **Resumable sessions** โ Research state is saved to `state.json`; pick up where you left off if a session is interrupted
- **Complete deliverables** โ Executive summary, full sectioned report, bibliography, and an optional interactive website โ all generated automatically
---
## How it works
```
User query
โ
โผ
Phase 1: Question Scoping
โโ AskUserQuestion โ focus, depth, audience, sources
โ
โผ
Phase 2: Retrieval Planning
โโ Break into 3-5 subtopics โ search query generation โ plan approval
โ
โผ
Phase 3: Iterative Querying โโโโโโโโโโโโโโโโโโโโ
โโ Web Research Agent (x2-3) โ
โโ Academic/Technical Agent (x1-2) โ refine if gaps
โโ Cross-Reference Agent (x1) โ
โ โ
โผ โ
Phase 4: Source Triangulation โโโโโโโโโโโโโโโโโ-โ
โโ Cross-verify key claims (โฅ2 sources) โ AโE quality rating
โ
โผ
Phase 5: Knowledge Synthesis
โโ Structure โ write sections โ inline citations
โ
โผ
Phase 6: Quality Assurance
โโ Hallucination check โ citation verification โ completeness
โ
โผ
Phase 7: Output & Packaging
โโ Executive summary + full report + bibliography + website (optional)
```
---
## Commands
| Command | Description |
|---------|-------------|
| `/insane-research [topic]` | Start a new research session |
| `/insane-research resume [session_id]` | Resume a previous session |
| `/insane-research status` | View all session progress |
| `/insane-research query` | Launch the structured query builder |
| `/insane-research refs <topic>` | Light mode: collect reference images only (a few live pages + their large images, no report) |
| `/insane-research` | Open the interactive menu |
### Natural language triggers
```
deep research on [topic]
research [topic]
[topic] ๋ฆฌ์์นํด์ค
๋ฅ๋ฆฌ์์น [์ฃผ์ ]
์ฌ์ธต ์ฐ๊ตฌ [์ฃผ์ ]
```
---
## Agents
Three agent types run in parallel during Phase 3:
| Agent | Count | Focus |
|-------|-------|-------|
| Web Research | 2โ3 | Latest news, trends, market data |
| Academic / Technical | 1โ2 | Papers, specs, official docs |
| Cross-Reference | 1 | Fact-checking key claims |
---
## Source Quality Ratings
| Grade | Type | Examples |
|-------|------|---------|
| **A** | Peer-reviewed, systematic reviews | Nature, Lancet, IEEE |
| **B** | Official docs, clinical guidelines | FDA, W3C, WHO |
| **C** | Expert opinion, industry reports | Gartner, conferences |
| **D** | Preprints, white papers | arXiv, company blogs |
| **E** | Anecdotal, speculative | Social media, forums |
---
## Output Structure
```
RESEARCH/{topic}_{timestamp}/
โโโ state.json # Session state (for resume)
โโโ README.md # Navigation guide
โโโ outputs/
โ โโโ 00_executive_summary.md # 3โ5 page summary
โ โโโ 01_full_report/ # Full sectioned report
โ โโโ 02_appendices/ # Supporting material
โ โโโ comparison_data.json # Structured comparison data
โโโ sources/
โ โโโ sources.jsonl # Collected sources
โ โโโ bibliography.md # Formatted bibliography
โ โโโ quality_report.md # Source quality ratings
โโโ website/ # (optional) Interactive presentation
โโโ index.html
โโโ styles.css
โโโ script.js
```
---
## Requirements
- [Claude Code](https://docs.anthropic.com/claude-code) CLI
- WebSearch (built-in) or a web search MCP server
### Optional MCP servers (enhance search coverage)
- Firecrawl
- Google Search MCP
- Exa Search
---
## License
MIT
---
<div align="center">
**Research that cites its sources. Every time.**
</div>