Skip to content

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)