# Use Cases

These tutorials are the fastest way to understand what Biblicus does: each one is a runnable
script that produces concrete artifacts (evidence, context, or transformed text), and each one is
covered by behavior specs so we can keep the tutorials honest over time.

**Tutorials**

- [Notes to Context Pack](use-cases-notes-to-context-pack.html)
- [Folder Search With Extraction](use-cases-text-folder-search.html)
- [Mark Sensitive Text for Redaction](use-cases-text-redact.html)

**Advanced tutorials**

- [Sequence Graph With Markov Analysis](use-cases-sequence-markov.html)

## How to run the tutorials

All scripts assume you are running from the repository root with a Poetry environment:

```bash
poetry install --with dev
```

Each tutorial script accepts:

- `--corpus <path>`: where to create or reuse the managed folder for the tutorial (called a *corpus* in the docs)
- `--force`: purge that folder before running the tutorial

Some tutorials can run in both mock mode and real API mode. When a tutorial requires external
services, its integration behavior is also covered by `@integration` behavior specs.
