Before: A polished story targets a persona nobody defined.
Every story points to a real persona
The assistant uses only the declared audience and turns missing user context into a decision needed from the team.
HINT for Product Managers
Your assistant drafts PRDs fast. HINT keeps the product intent intact.
HINT stores goals, personas, non-goals, metrics and decisions as plain-text notes beside product documents. Your assistant reads the relevant product context before refining a story or roadmap.
Where it helps
Three situations your team will recognize
Before: A success metric arrives with an invented baseline.
Metrics carry definitions and sources
A number without a source stays an open question instead of becoming a credible-looking KPI.
Before: A nice-to-have quietly enters the committed scope.
Priorities and non-goals remain boundaries
Trade-offs are surfaced for the product owner rather than settled invisibly during drafting.
See it
A real product story from the demo
The Hooli demo pins a Nucleus story to an approved product source.
demo-hooli-product/products/nucleus/prd-compression.md.hint ↗
# read Approved source
../../sources/approved.md
# story nucleus-1 {#product_manager_demo}
Approved story grounded in SRC-1.
# never Invented detailsWhat your assistant does next
It drafts criteria that stay inside the product scope and refuses to add a persona, baseline or trade-off decision that SRC-1 does not support.
What your AI assistant receives
<story name="nucleus-1">
Approved story grounded in SRC-1.
</story>
<never name="Invented details">…</never>Your boundaries stay visible
What it will never do
- Invent a persona, metric baseline or research finding.
- Promote optional work without an explicit priority decision.
- Pull a declared non-goal back into scope.
FAQ
Questions product managers ask
Can it write a PRD?
It can help your assistant draft one from declared product context and create a derivable skeleton where an emit pack applies.
Can it choose priorities?
No. It presents declared priorities and marks unresolved trade-offs as decisions needed.
Can PM and engineering books work together?
Yes. Product stories and engineering contracts can share the common core while retaining their specialist vocabulary.
For your technical colleague
The vocabulary
A hintbook is a vocabulary for your profession—installed, not written by you.
product- Sets the product area whose context applies.
persona- Defines a user group from known research.
goal- States the measurable outcome the work serves.
metric- Defines a measure together with its baseline source.
story- Records a user story with a stable identifier.
criteria- Sets testable acceptance conditions for a story.
hypothesis- States a belief that an experiment can test.
launch- Collects explicit go and no-go conditions.
Manual setup
Bootstrap is read-only: it prints instructions for the assistant. The assistant performs the installation.
npm install -g @openhint/cli
hint config
hint add @openhint/hintbook-product-manager
hint apply
hint verify products/nucleus/prd-compression.md
hint emit products/nucleus/prd-compression.md