deep-research-kit: Claude Code’s Research Engine for Resumable, Source-Checked Investigation
A 7-phase orchestration system that turns research into a stateful workflow, grades evidence before synthesis, and keeps queries anchored to the current year.
- deep-research-kit turns Claude Code from a prompt runner into a resumable research workflow with explicit phase gates.
- Its strongest move is epistemic, not aesthetic: sources are graded, triangulated, and allowed to fail before synthesis continues.
- Date-aware query generation keeps the system from drifting into stale answers that look current but are not.
- State persistence makes long investigations recoverable, so a crash or pause does not reset the entire inquiry.
Most AI research tools are built to impress you in one shot. You ask a question, the model searches, then it delivers a fluent answer that may or may not deserve your trust. deep-research-kit takes a different bet: research should behave like a lab process, not a chat response.
That matters because real research is messy. Sources conflict, searches drift stale, and good answers often require backing up, refining a query, and trying again. This repo encodes that mess into a controlled pipeline, so Claude Code can stop acting like a fast summarizer and start acting like a disciplined operator.
The problem with one-shot AI research
The failure mode is familiar. A model retrieves a few pages, blends them together, and produces a polished paragraph that hides weak evidence behind confident prose. If the session breaks, the state is gone. If the sources are thin, the synthesis still comes out looking complete.
deep-research-kit is built to push back on that default. It makes the investigation resumable, forces phase discipline, and treats weak evidence as a reason to revise the search instead of just moving on.
Deep Research AI ê¸°ë° ë©í°ìì´ì í¸ ë¥ë¦¬ìì¹ ìì¤í -- ìì¤ ê²ì¦ê³¼ 구조íë 리í¬í¸ë¥¼ ìëì¼ë¡ ìì±í©ëë¤.
Inside the 7-phase research machine
The system is organized as a staged pipeline rather than a loose bundle of prompts. Research begins with scope and decomposition, moves into retrieval, then triangulation and synthesis, and finally critique and packaging. The point of the phases is not ceremony. It is control.
The architecture matters because it refuses to let a later phase pretend earlier work was sufficient. If retrieval is weak, triangulation has to say so. If triangulation fails, synthesis does not get to hide the gap with better wording. That is a small change in shape with a big change in output quality.
Why the state machine matters
The orchestration layer, centered on orchestrator.py, is what makes the whole system feel persistent. It stores research state in JSON, tracks phase status, and allows a session to resume without pretending the previous work never happened. That turns a fragile agent run into a recoverable process.
class ResearchPhase(Enum):
INIT = "init"
DECOMPOSE = "decompose"
RETRIEVE = "retrieve"
TRIANGULATE = "triangulate"
SYNTHESIZE = "synthesize"
CRITIQUE = "critique"
PACKAGE = "package"
COMPLETED = "completed"
class PhaseStatus(Enum):
PENDING = "pending"
RUNNING = "running"
COMPLETE = "complete"
FAILED = "failed"
That kind of structure sounds boring until the CLI crashes, or the user stops mid-session, or a subtopic needs a second pass. Then it becomes the difference between a durable investigation and a lost conversation.
Evidence is not equal: the quality rubric
The repo’s epistemic backbone is its quality rubric. Instead of treating every source as interchangeable, it assigns weight by credibility, freshness, and usefulness. The key move is not just counting sources. It is ranking them.
| Grade | What it means | How the system treats it |
|---|---|---|
| A | Primary, high-confidence evidence such as peer-reviewed or authoritative technical sources | Strong weight in triangulation and synthesis |
| B | Solid secondary evidence with clear sourcing | Useful support, but not enough alone |
| C | Mixed or indirect evidence | Can fill gaps, but needs corroboration |
| D | Weak or partial evidence | Flagged for caution and usually not decisive |
| E | Anecdotal or low-trust material | Useful mainly as a signal to search elsewhere |
This is what separates a research workflow from a content generator. A single strong source can outweigh a pile of weak ones, and the system is willing to backtrack when the evidence does not hold up.
How it avoids stale answers
One of the smartest parts of the system is its date awareness. Query generation is nudged toward the current year and recency operators, which reduces the chance that a model leans on old assumptions or stale web pages. That is a simple fix for one of the most common research failures in LLM workflows.
This is not about making search cleverer in the abstract. It is about anchoring the investigation in the present tense of the web, so the output tracks what is actually current rather than what the model vaguely remembers.
Parallel agents, but with boundaries
The repo uses parallel task execution, but it does not confuse concurrency with freedom. Multiple agents can explore in parallel, yet they still feed a single process with phase discipline and shared state. That gives you speed without turning the workflow into a pile of disconnected guesses.
| Dimension | Typical agent chain | deep-research-kit |
|---|---|---|
| State | Often ephemeral | Persisted in JSON and resumable |
| Progression | Mostly linear | Phase-gated with backtracking |
| Sources | Collected as found | Graded and weighted |
| Search | Can drift stale | Date-aware by design |
| Concurrency | Fast but loose | Parallel with boundaries |
The design choice is subtle. It does not ask whether parallelism is possible. It asks how much parallelism the process can absorb before evidence quality starts to slip.
What this changes compared with normal deep-research tools
Compared with a one-shot search-and-summarize tool, deep-research-kit is less theatrical and more reliable. Compared with a simpler agent chain, it adds memory, phase gates, and evidence grading. Compared with generic deep research products, it is more explicit about why one source should beat three weaker ones.
That makes it useful for people who care about repeatability. If you need a report you can defend, not just a response you can paste, the difference is not cosmetic.
| Capability | deep-research-kit | Typical deep research tool |
|---|---|---|
| Resumable workflow | Yes | Often no |
| Evidence grading | Explicit A to E rubric | Usually implicit |
| Backtracking | Built in | Ad hoc or absent |
| Temporal awareness | Query generation stays current | Often forgotten |
| Claude Code native | Yes | Often external or wrapped |
Who built this for whom
This is not a mass-market toy. It reads like a tool for Claude Code power users, technically fluent researchers, and operators who want their AI workflows to be inspectable. The multilingual documentation and disciplined file structure reinforce that sense of maturity.
The intended user is someone who values process as much as output. They do not want a black box that sounds smart. They want a system that can explain where its evidence came from, where it got stuck, and how it recovered.





