Skip to main content

ADR-034 β€” Specialist role metadata

Status: Data-model decision retained; per-turn prompt behavior superseded by ADR-046 Originally accepted: 2026-06-29

The nullable specialists.prompt_template_key column was introduced as Specialist-scoped catalog metadata to prevent a KYC Specialist from inheriting an unrelated e-commerce role. Its closed legacy values and migration remain a database compatibility concern.

It is not a Humanwork prompt selector for managed turns. Humanwork must not:

  • render an agent/prompts template into the inbound message;
  • send the key as a per-turn persona or role override;
  • use it to classify the task, narrow tools, or select a response schema; or
  • fall back to a global prompt when the key is absent or unknown.

Stable persona and configured skills are established in the new Hermes session's AgentFS configuration. Hermes owns its system prompt, skill loading, retrieval, tools, and response construction thereafter. If the legacy column is eventually removed, that is an ordinary expand-contract migration; no runtime fallback must be recreated.