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

# eval

> The thesis harness: golden questions vs baselines

```bash theme={null}
duckbrain eval [--modes bm25,vec,hybrid]
```

Runs the golden-question sets (core + paraphrase) against each mode and reports hit\@5 and tokens-per-query. Run from the repo root (the corpus paths are repo-relative).

This is the gate for every retrieval feature: **a mode or ranking stage only becomes the default when it beats the current default here.** Current standing: BM25 default; hybrid ships opt-in after tying (not beating) it.