# Maven project dictionary for the direct-prose skill.
#
# These terms override every word preference in the skill's word-choice tables.
# Each entry exists because the name drifted in real docs or real answers, not
# because the word looked improvable.
#
# Format and the rule for adding a term: ~/.claude/skills/direct-prose/references/modes.md

terms:
  resident_model:
    name: resident model
    meaning: the one always-warm Qwen3-1.7B llama-server that both routes and phrases
    avoid:
      - the model
      - the LLM
      - the 1.7B
      - the phraser model
    examples:
      good: The resident model emits GBNF-constrained JSON.
      bad: The 1.7B emits GBNF-constrained JSON.

  router:
    name: router
    meaning: the stage that turns an utterance into a Decision with one of 7 intents
    avoid:
      - orchestrator
      - intent classifier
      - dispatcher

  classifier:
    name: classifier
    meaning: the embedder nearest-neighbour path that runs when the router is off or errors
    avoid:
      - the fallback
      - the floor
      - the old router
    examples:
      good: A router error falls through to the classifier.
      bad: A router error falls through to the floor.

  cascade:
    name: cascade
    meaning: the ordered path stage 0, then router, then classifier
    avoid:
      - the pipeline
      - the chain
      - the fallback chain

  stage_0:
    name: stage 0
    meaning: the deterministic rules that answer before the resident model is called
    avoid:
      - the fast path
      - bypass
      - deterministic assist
      - preemption
    examples:
      good: Stage 0 routes agenda questions to IntentQuery.
      bad: The bypass routes agenda questions to IntentQuery.

  query_source:
    name: query source
    meaning: one entry in querySources, which either claims a turn or passes
    avoid:
      - arm
      - handler
      - branch
      - answerer
    examples:
      good: Kiwix is the last query source before the model answers from memory.
      bad: Kiwix is the last arm before the model answers from memory.

  personal_boundary:
    name: personal boundary
    meaning: the query source that stops a question about him from reaching the world
    avoid:
      - the boundary
      - the privacy gate
      - the personal filter

  clarify:
    name: clarify
    meaning: the turn outcome where Maven asks instead of acting
    avoid:
      - refusal
      - rejection
      - punt
    examples:
      good: The gate produced two false clarifies.
      bad: The gate produced two false refusals.

  fact:
    name: fact
    meaning: a keyed, supersedable row in the fact store
    avoid:
      - memory entry
      - datum
      - record

  note:
    name: note
    meaning: free text he captured, indexed for recall
    avoid:
      - memo
      - entry

  memory:
    name: memory
    meaning: the embedded index over notes and facts that backs recall
    avoid:
      - RAG store
      - vector db
      - long-term memory

  nudge:
    name: nudge
    meaning: one proactive message the digestion worker proposes and the dispatcher sends
    avoid:
      - suggestion
      - proposal
      - proactive prompt
      - reminder
    examples:
      good: A fact can close the nudge that asked for it.
      bad: A fact can close the suggestion that asked for it.

  digestion_worker:
    name: digestion worker
    meaning: the background engine that consolidates memory and proposes nudges
    avoid:
      - digestion tick
      - background engine
      - reflection loop

  reach:
    name: reach
    meaning: an outbound channel Maven speaks through, such as telegram, ntfy or voice
    avoid:
      - sink
      - delivery channel
      - notification backend

  ecosystem:
    name: ecosystem
    meaning: Nexus, Praxis and Hexis together
    avoid:
      - the services
      - the integrations
      - upstream

  act:
    name: act
    meaning: the intent that runs a capability through Hexis
    avoid:
      - action
      - command
      - execution
    examples:
      good: An act with no allowlisted fn is gated to a clarify.
      bad: An action with no allowlisted fn is gated to a clarify.