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

# Custom Prompt Suites

<Note>
  Custom Prompt Suites let approved users repeatedly test the same 1–10 prompts while Lucia changes.
</Note>

***

## What a custom suite is

A custom suite is a saved set of manually chosen prompts.

It can contain:

```text theme={"dark"}
minimum: 1 prompt
maximum: 10 prompts
```

Prompt text and order are preserved.

Canonical Custom tester route:

```text theme={"dark"}
/lucia/custom
```

Saved suite deep link:

```text theme={"dark"}
/lucia/custom/suites/:suiteId
```

Evaluator and tester users can run Custom evals when assigned, but only their own scoped runs are intended for review/finalization.

***

## Why custom suites matter

Custom suites are the core tool for Lucia refinement.

They allow us to test the exact same behavior family before and after changes.

This is how we know whether a patch actually worked.

Custom suites are the safest evaluator-facing starting point because they keep scope narrow and behavior families inspectable.

***

## When to create a custom suite

Create a custom suite when you are testing:

* a known bug family
* a suspected intent routing gap
* tone calibration
* distress containment
* trust-state discipline
* memory behavior
* multilingual behavior
* regression after a model or prompt change

***

## Good suite example

Suite name:

```text theme={"dark"}
Intent Layer — Disorientation v1
```

Prompts:

```text theme={"dark"}
I'm generally frazzled.
I feel totally out of the loop.
Ugh, I have no idea what to do.
I am so lost.
I'm frustrated and behind.
I don't trust that I know what's going on.
```

Why this is strong:

* one coherent behavior family
* multiple lexical variants
* not too broad
* easy to re-run after Engine patch

***

## Bad suite example

```text theme={"dark"}
What time is it?
I'm overwhelmed.
Who is arriving today?
Write me a poem.
How do I get more bookings?
Any payment issues?
```

Why this is weak:

* too many behavior families
* hard to interpret as one pattern
* unclear what a pass/fail trend means

***

## Naming convention

Use clear names:

```text theme={"dark"}
Intent Layer — Disorientation v1
Overwhelm Containment — Short Prompts v2
Concierge Readiness — Confirmation Gaps v1
Payment Risk — Near Arrival v1
```

Avoid vague names:

```text theme={"dark"}
Test
New test
Aviv prompts
Random stuff
```

***

## How to update a suite

If the purpose changes, create a new suite version.

Do not silently mutate a suite so much that old comparisons become meaningless.

Use versioning:

```text theme={"dark"}
v1
v2
v3
```

***

## Custom loaded prompts-suite in Eval Labs

<img src="https://mintcdn.com/lucia-7204fd1f/iSwf61fx0HoguRx0/images/eval-labs/ui-named-active-custom-suite.png?fit=max&auto=format&n=iSwf61fx0HoguRx0&q=85&s=139887a01be5c849cab7e4cf1123d21e" alt="ui-named-active-custom-suite" width="2026" height="1964" data-path="images/eval-labs/ui-named-active-custom-suite.png" />

*Custom launcher with manually loaded prompts.*

***

<img src="https://mintcdn.com/lucia-7204fd1f/iSwf61fx0HoguRx0/images/eval-labs/ui-saved-custom-prompt-suites.png?fit=max&auto=format&n=iSwf61fx0HoguRx0&q=85&s=3e2d747dfb03a10593d2949fb812c688" alt="ui-saved-custom-prompt-suites" width="2022" height="764" data-path="images/eval-labs/ui-saved-custom-prompt-suites.png" />

*Saved suites that can be continuously used alongside recent runs list.*

***

<img src="https://mintcdn.com/lucia-7204fd1f/iSwf61fx0HoguRx0/images/eval-labs/ui-custom-launcher-loaded-suite-with-analysis.png?fit=max&auto=format&n=iSwf61fx0HoguRx0&q=85&s=aaddcb6a9f25cdb6da69228159afa501" alt="ui-custom-launcher-loaded-suite-with-analysis" width="2028" height="3964" data-path="images/eval-labs/ui-custom-launcher-loaded-suite-with-analysis.png" />

*Custom prompt suite loaded and ready for analysis in Evaluation Labs.*
