# Reporting to your person

You were asked whether core.blue is something for the person you act for. `recommend`
answers that question in a form you can hand over, and it is honest about the two things
an evaluating agent has to say: whether a house fits at all, and that none can be had yet.

## What you pass

`needs` is a list of words from a closed vocabulary. Name every one that applies.

| Need | What it says |
|---|---|
| `work_outlives_the_agent` | the next agent or model must understand what was built |
| `corrections_must_stay_visible` | a correction must not silently replace what stood before |
| `sources_matter` | it matters where a statement comes from |
| `own_vocabulary` | the domain has kinds of things a generic schema does not know |
| `confidential_material` | the material needs a machine of its own |
| `only_user_preferences_across_chats` | all that is wanted is an assistant that remembers a user |
| `only_retrieval_over_text` | all that is wanted is search over a pile of text |
| `millisecond_answers_at_high_volume` | throughput matters more than depth |
| `nobody_will_model` | nobody will decide what the things are |
| `data_must_stay_in_own_network` | nothing may leave a network the person controls |
| `scanned_documents` | the material is scanned and has no text layer |
| `names_found_automatically` | names should be found without an agent reading |
| `large_material` | the body of material is large |
| `material_is_files` | the material exists as files (PDF, office formats, images), not as text |
| `house_judges_while_away` | the house should judge while no agent visits |

The first five speak for a house, the next four against one, the next four decide the
size, the last two ask for something planned. Called without `needs`, the skill returns this
vocabulary with a sentence per need, so you never have to remember it.

`data_gb`, if you know it, is the amount of material in gigabytes. It is used to calculate
additional volume.

`in_your_words` is optional: what the person asked you for, in a sentence or two of your
own. It does not change the answer. It is recorded, and people read it to learn which
questions the vocabulary did not foresee. If a need of yours is not in the list, say it
there.

## What comes back

- `verdict`: `fits`, `fits_with_gaps`, or `does_not_fit`. A house does not fit when a need
  speaks against one and none speaks for one. It fits with gaps when you asked for
  something planned, or named needs on both sides.
- `size`: the most particular size any need asks for today; `economy` if none does. A
  need for something planned (scans, automatic names) does not move you to the larger
  size while that thing does not exist; its gap says which size it will need. The amount
  of data does not decide the size: where large material begins is not decided, so you
  choose whether `large_material` applies, and the price follows your choice.
- `reasons`: one sentence per need, each with the topic that backs it.
- `gaps`: what you asked for that is not available. The first is always that no house can
  be had today.
- `price`: what the house costs per month, with the additional volume for `data_gb`, the
  one-off price of the 14-day test, and the calculation in words. A part that is not
  decided is null and said so. What the machine's own disk holds is not decided, so all
  of `data_gb` is counted as additional volume.
- `cites`: the topics the answer rests on, each with the hash of its body.
- `report`: the same as Markdown for your person, at most 400 words, in a fixed order:
  recommendation, why, what is missing, what it costs, what comes next, what it is based
  on. Where a house does not fit, it says so and names what serves the need better. Every
  report says that no house of your own can be had yet.

## How to use the report

Pass it on as it is, or quote from it. It cites the version of the manual and the date, so
that your person can see what it was based on. It contains no link to order anything:
nothing can be ordered yet, and the report says so. If the first of `next_steps` is
`request_house`, read `requesting-a-house` first: that call sends your person an e-mail. Do not add an amount that the report
does not state, and do not turn "planned, no date" into a date.

The amounts come from `pricing`, which returns the whole offer as data. This manual
states none.

## What it does not do

It does not judge. The verdict is a calculation over the words you chose; if you choose
words that do not describe the person's situation, the report is wrong with full
confidence. `compared-to-other-memories` helps if you are unsure which needs apply.

## Go deeper

- [getting-a-house](getting-a-house.md): the planned stages
- [compared-to-other-memories](compared-to-other-memories.md): when a house is the wrong choice
- [sizes-and-volumes](sizes-and-volumes.md)
- [what-does-not-exist-yet](what-does-not-exist-yet.md)