Advisor — Advisory Workspace¶
The Advisor answers from what has been published. It is a read-only consumer of the corpus: it runs analytical verbs against the current published version and grounds every result in source passages (cite-then-verify). The Advisor makes no changes to the brain.
Named Counselor in code
You may see the identifier counselor in URLs and settings — it refers to the Advisor.
Before you can use it¶
The Advisor serves published versions only. Until a version has been certified in the Librarian:
- If the brain is empty, the Advisor shows an empty-brain state.
- If there is a draft but no published version, you'll see "No published version yet" with a prompt to approve change sets and certify a version first.
The Advisor dashboard¶
The header — Advisory workspace — shows which version is being served (e.g. Serving v0.3), an Artifacts button, and a settings gear.
When no result is open, the body shows a Ready state: a row of usage stat tiles and an Actions panel of verb cards. Running a verb produces an artifact, which replaces the ready state with a two-column result view.
The verbs¶
| Verb | Purpose |
|---|---|
| Answer | Answer a question from the published corpus. |
| Assess | Evaluate something against the brain's rubrics/criteria and return findings. |
| Redline | Mark up / compare content against the corpus. |
| Retrieve | Pull the most relevant source passages. |
| Draft | Coming soon (Phase 3) — shown disabled. |
Verbs are role-gated: one outside your role is dimmed with a lock icon and a tooltip explaining what's required.
Reading an artifact¶
A result artifact is laid out in two columns:
Left — the assessment
- An Assessment badge, the verb, and the brain version it ran against.
- A verdict banner with a confidence percentage.
-
A list of findings, each tagged by level:
- gap — something missing or non-compliant.
- ok — satisfied.
- advisory — a note to consider.
Each finding shows its clause, text, and reference.
Right — the grounding
- Source grounding — a citations panel with an N/N entailed badge and per-citation cards (source, relevance score, location, and a snippet). This is how you verify that a claim is actually supported.
- Retrieval trace — a timeline of the processing pipeline stages with timings, so you can see how the answer was produced.
What the Advisor does not do¶
- It does not modify the corpus — that is the Librarian's job.
- It does not serve drafts — only certified, published versions.
- There is no approval step here; the Advisor is a pure consumer.
Role summary¶
| Action | Minimum role |
|---|---|
| Consult the Advisor (permitted verbs) | Reader (per-verb gating applies) |