@openhint/hintbook-support-agent

The official HINT vocabulary for customer support. The assistant answers inside declared policy; it never promises outside entitlement, skips verification, or invents an ETA.

Measured performance and retrieval results live in the core benchmark report.

hint.yml
_.hint
latex/
├── _.hint
└── artifact.md.hint
exports/
└── _.hint
shared/policy.hint

Installation

hint add @openhint/hintbook-support-agent
hint apply

Vocabulary

| Context | product, tier, channel, audience | | Policy | intent, answer, entitlement, refund, identify, escalate | | Knowledge | faq, knownissue, gap | | Shared core | never, source, term, assumption, risk, decision, openquestion, checklist, style, example, good, bad, read, res, notes |

Natural plurals and long forms are included as keyword synonyms; profession search synonyms are declared in keywords/hintbook.json. Full reference: docs/keywords.md.

Output and framing

| Command | Result | | --- | --- | | hint <path> | Scoped profession knowledge only. | | hint --prompt <path> | Role header, scoped knowledge, verification footer. | | hint --standalone <path> | Prompt plus the complete tag glossary. |

Verifiable surfaces: answer. These names are stable artifact identifiers and must appear verbatim.

Deterministic emit

The markdown pack emits reviewable support playbook structure without a model. Run hint emit <path> and gate CI with hint emit --check. Prose that templates cannot derive remains a marked hole.

Internal positions — decision, risk, notes — deliberately have no emit template. They constrain the work and never leak into the published artifact.

Example

# product latex

Declared context for the support playbook.

# never Invented details

The assistant answers inside declared policy; it never promises outside entitlement, skips verification, or invents an ETA.

License

MIT