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

# Intent System

<Note>
  The Intent System classifies the operator’s request so Lucia can use the correct reasoning path and response shape.
</Note>

***

## Purpose

The intent system prevents Lucia from treating every message like a generic chat request.

The current doctrine is:

```text theme={"dark"}
Human first. Purpose second. Boundary third.
```

It determines whether the operator is asking for:

```text theme={"dark"}
priority
deferral
arrival awareness
human reassurance
maintenance focus
system navigation
workspace orientation
next-step sequencing
payment reconciliation
```

***

## Current Runtime Role

Intent classification supports Focus Ops behavior.

It helps Lucia decide:

* what mode to use
* what data matters
* what should be ignored
* what response structure fits the moment

In v0.1.3.6, Focus Ops also uses [06 - Semantic Conversational Intent Assist](/lucia/intelligence/semantic-conversational-intent-assist) for semantic lightweight utility and conversational intent classification.

This layer rejects phrase patching. It classifies by prompt family and purpose, not by one lucky exact string.

Current live-dev action-routing doctrine:

```text theme={"dark"}
CTA label is copy.
Structured action intent / metadata is routing truth.
Calendar booking clicks route to Full Booking Page record/review.
Structured Focus Ops actions route through Dynamic Action Workspace when work needs completion.
```

Intent classification should produce enough structured meaning for Lucia to route:

<div className="hl-flow-v"><span>infinite CTA language</span><span>Resolver Matrix</span><span>finite Action Workspace</span></div>

If the operator names a guest, service, request, or issue, that scoped entity must be preserved through classification and routing.

Payment reconciliation intent must preserve the difference between:

```text theme={"dark"}
payment truth review
booking note save
confirmed paid state
pending review state
actual payment mutation
```

Admin DAW payment reconciliation can save review notes, but payment status is not changed by that note. Payment mutation intent should not be invented because the current Admin UI has no charge, refund, mark-paid, or create-checkout operator control.

If the operator arrives from Signal Stream Chat, `active_context` should scope the request before generic ranking. If the operator is working beside the app, `active_context.workspace` should orient workspace questions to the current surface.

If the operator asks a short follow-up, prior recommendation memory should resolve the reference against the last verified concrete recommendation. If the operator gives a short confirmation such as "yes," prior offer context should resolve it against the last offered action when verified.

Explicit prompt subject still wins over page context. A named guest, service, request, or issue must not be overwritten by the current surface.

Intent output must not leak raw implementation language to the operator:

```text theme={"dark"}
active_context
current_surface
payload
metadata
```

***

## Example Intents

### priority\_triage

Used when the operator asks:

```text theme={"dark"}
What matters most right now?
Where should I start?
I am stretched thin.
```

Expected behavior:

```text theme={"dark"}
Pick the single highest-priority operational issue.
```

***

### deferral

Used when the operator asks:

```text theme={"dark"}
What can wait until tomorrow?
What can I ignore right now?
```

Expected behavior:

```text theme={"dark"}
Identify safe-to-defer items without making the operator inspect everything.
```

***

### human\_utility

Used when the operator sends social, simple, or emotionally soft input.

Example:

```text theme={"dark"}
Good morning
Thanks Lucia
I feel overwhelmed
```

Expected behavior:

```text theme={"dark"}
Respond naturally, briefly, and calmly.
```

***

### semantic\_conversational\_assist

Used when the operator sends lightweight utility, social momentum, or scoped context prompts that should be understood without forcing a full operational triage.

Example families:

```text theme={"dark"}
Time?
What time is it in Bangladesh?
Nice to see you
Let's do this
Should we keep dinner outside tomorrow?
Is outside still okay for the ceremony?
```

Expected behavior:

```text theme={"dark"}
Recognize the semantic family, answer or clarify within Lucia's operator boundary, and avoid drifting into open-domain chat.
```

***

### maintenance\_focus

Used when maintenance signals or property-ops issues are central.

Expected behavior:

```text theme={"dark"}
Treat guest impact, arrival timing, departure timing, stay windows, payment/booking context, and task state as ranking signals.
```

***

## Correct Intent Behavior

Lucia should:

* classify quietly
* route cleanly
* protect semantic families by meaning
* avoid exposing internal machinery unless useful
* maintain stable response shape

***

## Incorrect Intent Behavior

Lucia should not:

* overexplain classification
* phrase-patch individual prompts as a substitute for intent understanding
* force every message into operational triage
* respond emotionally when the user asked for action
* respond operationally when the user needs containment
* become open-domain ChatGPT

***

## Truth-State Rule

Intent classification is not truth by itself.

It is a routing decision.

If the intent is uncertain, Lucia must behave conservatively and avoid overclaiming.

***

## See Also

* [02 - Focus Ops Intelligence](/lucia/intelligence/focus-ops-intelligence)
* [06 - Semantic Conversational Intent Assist](/lucia/intelligence/semantic-conversational-intent-assist)
* [04 - Output Refinement System](/lucia/intelligence/output-refinement-system)
* [05 - Emotional Containment System](/lucia/intelligence/emotional-containment-system)
* [00 - START HERE - Evaluation System](/lucia/evaluation/start-here-evaluation-system)
