> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research Agent Starter

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

## Summary

This starter turns the deep-research case study into a small project skeleton
centered on planning, evidence collection, and citation-aware synthesis.

## Status

`starter`

Source code: [case-studies/examples/deep-research-agent-starter](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/case-studies/examples/deep-research-agent-starter)

## Why It Exists

Deep research is a flagship agent product shape in this repo. A small starter
makes it easier to contribute traces, artifacts, and evaluation ideas later
without copying a full external implementation.

## Related Lab Pages

* [Deep Research Agents](/case-studies/deep-research-agents)
* [Case Studies Overview](/case-studies)

## Folder Structure

```text theme={null}
deep-research-agent-starter/
├── index.mdx
└── src/
    ├── citation_formatter.py
    ├── research_loop.py
    └── research_review.py
```

## Quick Start

This is a starter, not a finished product. The code sketch focuses on the core
loop and leaves transport, UI, and persistence out of scope. For a repo-level
smoke check, run `python3 scripts/verify_example_projects.py` from the
repository root.

## Included Sample Files

* `src/research_loop.py`: the minimal planning, evidence, and draft-report loop
* `src/citation_formatter.py`: a tiny reference surface for turning evidence
  rows into readable citations
* `src/research_review.py`: a small post-research quality check for evidence
  coverage before publication

## Constraints

* No search adapter is implemented.
* Citation formatting is illustrative.
* Artifact persistence is not wired yet.

## Next Steps

* Add a real evidence store.
* Add a report artifact writer.
* Add evaluation cases for missing or weak evidence.