Your First Query

Submitting a query to WRAAS is straightforward. The harder part is accepting the response.

Step 1: Frame your question

Before submitting, ensure your question is well-scoped, includes the relevant context, and refers to a decision that has not already been made. Consulting existing Decision Matrix Engine (DME) entries before querying is considered good practice and will reduce sigh intensity.

ℹ️

Note

WRAAS will evaluate the full option space regardless of how the query is framed. Providing context reduces the option space to a manageable size. Both approaches are evaluated to completion.

Step 2: Submit

Use the wraas query command with the --input flag:

Terminal

$ wraas query --input "should we add a caching layer?"

> Parsing decision matrix...
> Generating full option space (including obviously wrong ones)...
> Option A: add Redis — viable
> Option B: add a second database — documented, rejected (reason: DME-0047)
> Option C: add caching layer at the CDN edge — viable
> Option D: rewrite the entire service — documented, rejected (reason: DME-0001)
> Calibrating sigh output... [MILD]
> OUTPUT: "What are the cache invalidation requirements?"
> Confidence: 94.2% | Latency: 113ms

Step 3: Interpret the output

Each WRAAS response contains three signal components. The annotated output below highlights where each appears:

Annotated output

> Option B: add a second database — documented, rejected (reason: DME-0047)  ← rejection rationale
> Calibrating sigh output... [MILD]                          ← sigh intensity
> Confidence: 94.2% | Latency: 113ms                         ← confidence score

Signal	Location in output	How to read it
Confidence score	`Confidence: 94.2%`	The Decision Matrix Engine's certainty in the selected output. Above 90% indicates a clear recommendation. Below 75% suggests ambiguity — resubmit with additional context.
Sigh intensity	`[MILD]`	The calibrated exasperation level for the query. Levels range from `SILENT` to `EXISTENTIAL`. See Configuring Sigh Thresholds.
Rejection rationale	`DME-0047`	Each rejected option includes a DME entry ID linking to the full evaluation record. See Decision Matrix Entries.

💡

Tip

If WRAAS responds with only a question, that is the answer. The question is the output. Sit with it.