How it works Professions For Engineers For Lawyers Quick start
hint/professions/for lawyers
@openhint/hintbook-lawyer

Draft documents that hold the line.

No code. The lawyer hintbook applies the same machinery to legal drafting: declare the parties, clauses, obligations, and red lines in plain Markdown, and HINT compiles a binding brief for a senior attorney persona that drafts, revises, or audits — inventing no facts, names, amounts, dates, or citations.

contracts/nda.md.hint Markdown
Mutual NDA — Pearson Specter Litt matter. # jurisdiction NewYork Governed by the laws of New York. # party Receiving {#receiving} Hooli, Inc., a Delaware corporation. # clause Confidentiality ## obligation Protect Protect all Confidential Information with reasonable care. ## exception Compelled Disclosure compelled by law, on prior notice to the Disclosing Party. ## redline Survival Survives 5 years — never perpetual.

Defined-term discipline

A definition is defined once, capitalized as defined, with no synonyms — the assistant enforces it mechanically across every provision.

Red lines never trade away

A redline carries explicit never-concede language; a never block is enforced with the strongest wording in the book.

Gaps, not guesses

Missing figures, dates, and citations come back as reported gaps with their risk — never filled with something plausible.

The same power

The rigor software engineers have for code — now for your documents.

For decades, software teams kept their work inside hard borders: a written spec, versioned in the repo, reviewed line by line, built the same way every time. HINT brings that exact discipline to drafting. Your parties, clauses, and red lines become a specification that lives beside the document, travels through the same review, and compiles identically on every run.

What software engineers have had
  • Specifications that bind the build
  • Specs versioned in the repo, beside the code
  • Pull-request review against the spec
  • Deterministic builds — identical every time
  • Anti-patterns the pipeline refuses
What you have now
  • .hint specs that bind the draft
  • Specs versioned in your matter, beside the document
  • --mode review audits the document against the spec
  • Deterministic compiles — byte-identical drafts
  • Red lines the draft can never cross
The vocabulary

The whole anatomy of a legal norm — as heading depth.

No new syntax. An obligation under a clause, a remedy under a breach, a fallback under a position — nesting expresses the structure, and each keyword compiles into a binding drafting directive.

Matter context
mattercase · engagement
The matter itself: parties' goals, deal background, scope — informs every drafting decision.
partyparties
A party: exact legal name, role, capacity — used consistently, never varied.
jurisdictionlaw
Governing law and forum. Drafting follows its conventions; unenforceable requests get flagged.
definitionterm · defined
A defined term: defined once, capitalized as defined, no synonyms for the concept.
recitalwhereas · background
Background and intent for the recitals — context only, never operative obligations.
factfacts
A fact of the matter: treated as true, relied on exactly, never contradicted or embellished.
precedenttemplate · model read
A model document to follow, and documents to read first — reuse their structure and defined terms.
styletone · voice
Register and language all drafted text follows — plain English, active voice, house formatting.
Document structure
clauseprovision · section
A contractual provision drafted exactly as specified — scope, carve-outs, cross-references.
obligationduty · covenant
What a party must do: clear mandatory language, unambiguous who / what / when.
prohibitionrestriction
What a party must not do: clear "shall not" language, unambiguous who is bound.
rightentitlement
A right granted to a party: holder, scope, conditions, duration — neither broadened nor narrowed.
condition
A condition precedent or subsequent: its trigger, effect, and the consequence of failure.
exceptioncarve-out · proviso
A narrow carve-out applied exactly as stated — never swallows the rule it qualifies.
breach remedy
What constitutes breach, and the consequence that follows — none added, none waived.
representationwarranty
Who gives the warranty, what is asserted, and its qualifiers — none added or dropped.
liabilitylimitation indemnity
Caps, exclusions, baskets, and indemnities — declared figures only; a missing figure is a gap.
paymentfees deadline
Amounts, currency, schedule, durations, triggers. Missing figures are gaps, not blanks to fill.
termination notice dispute
Grounds and effects of termination, how notices are validly given, and the forum for disputes.
exhibitschedule · annex signature
Attachments referenced under their designation, and execution formalities — signatories and witnesses.
sourcestatute · basis
The law a provision must satisfy. Conflicts between spec and source get flagged, never silently resolved.
Positions & red lines
redlinerule
Client red lines, honored without exception — explicit never-trade-away language.
neverforbidden · banned
Content that must never appear — enforced with the strongest language in the book.
fallbackalternative
An ordered negotiation fallback: conceded in declared order, never past the last, never across a red line.
standardboilerplate
Required boilerplate and house drafting standards, applied without substitution.
risk checklist
Known risks the document must address, and a pre-delivery sign-off list verified before finishing.
Litigation & argument
claim argument
A cause of action and a developed argument — issue → rule → application → conclusion.
authoritycitation · caselaw
Authorities cited precisely, only for the stated point. Unverifiable citations are reported, never invented.
Drafting discipline
good bad
Mandatory drafting patterns to always follow, and patterns that must never be used.
examplesample
A worked example — form to match, not substance to copy.
actionprocedure
A repeatable procedure run exactly in order when invoked — conflict checks, defined-term sweeps, filings.
resresource
Material used verbatim — letterhead, riders, fixed boilerplate; never retyped or paraphrased.
notes
Author-facing notes dropped from the compiled prompt — open questions the assistant never sees.
See it compile

One spec. A binding brief. A severity-ranked audit.

The confidentiality clause becomes a draft prompt for a senior-attorney persona — then, under --mode review, a findings report that quotes the document's exact language against each block.

contracts/nda.md.hint
# clause Confidentiality ## obligation Protect The Receiving Party shall protect all Confidential Information with reasonable care. ## exception Compelled Disclosure compelled by law, on prior notice to the Disclosing Party. ## redline Survival Confidentiality survives 5 years after disclosure — never perpetual.
hint contracts/nda.mddraft
<clause name="Confidentiality"> <binding_obligation name="Protect"> The Receiving Party shall protect all Confidential Information with reasonable care. </binding_obligation> <exception name="Compelled"> Disclosure compelled by law, on prior notice to the Disclosing Party. </exception> <non_negotiable_position name="Survival"> Confidentiality survives 5 years after disclosure — never perpetual. </non_negotiable_position> </clause>

$ hint --mode review contracts/nda.md | claude -p

violation§ 4.2 → redline Survival

Quoted: "…shall survive in perpetuity." Directly violates the Survival red line (5 years, never perpetual). Correcting language: "…shall survive for five (5) years following disclosure."

gap§ 4 → exception Compelled

No carve-out for legally compelled disclosure. The Compelled exception is declared but absent from the draft. Add it with the prior-notice requirement.

risk§ 1.3 → definition Confidential Information

"confidential information" appears lower-cased. The defined term must be capitalized consistently throughout to remain enforceable.

Verdict: does not conform — 1 violation, 1 gap, 1 risk.

Three modes

Same spec. A senior attorney for each task.

compile · default

Draft

A senior attorney drafting from a binding specification.

Read parties, defined terms, governing law, and red lines first; draft complete documents — no bracketed stubs unless declared.

hint contracts/...
--mode fix

Revise

Where the document and the spec disagree, the document is wrong.

Smallest conforming revision; structure, numbering, defined terms, and style preserved; each change reported with its rationale. With a hint.lock it revises only the blocks that drifted — and returns the document unchanged when it already conforms.

hint --mode fix
--mode review

Audit

Findings, never redlines.

Walk the spec block by block, quote the document's exact language, hunt prohibited content and red-line breaches, rank by severity.

hint --mode review
In practice · demo-pearson-specter-litt

An employment agreement, specified before it's drafted.

The Pearson Specter Litt demo keeps the matter's parties, positions, and red lines in .hint files — so every draft, revision, and review answers to the same source of truth.

01

Set the matter baseline

A folder _.hint declares the jurisdiction, the party names, and the firm's drafting style — inherited by every document.

02

Declare the positions

The non-compete spec nests a prohibition, its condition and exception, a breach → remedy chain, and the source on restraint-of-trade limits.

03

Compile & draft

hint contracts/employment.md | claude -p produces a complete first draft with defined terms consistent and no invented figures.

04

Audit the counterparty's redline

--mode review checks their markup against your red lines — the perpetual-survival edit comes back as a flagged violation, not a missed one.

05

Verify & lock

hint verify confirms every declared party, definition, and exhibit is actually used in the draft — deterministic, no tokens — then hint lock records it, so unchanged specs are skipped and edits reconcile only what drifted.

contracts/employment.md.hint
# clause NonCompete ## prohibition Restraint The Employee shall not engage in any Competing Business. ### condition Scope Within the Territory during the Restricted Period. ### exception Passive Holdings under 3% in listed companies. ### source Enforceability limits on restraints of trade under the governing law.
Quick start

Set up a matter.

1 · install & register
# in the matter folder npm install -g @openhint/cli hint config hint add @openhint/hintbook-lawyer hint apply
2 · draft, revise, audit
# draft from the spec hint contracts/nda.md | claude -p # revise an existing document hint --mode fix contracts/nda.md | claude -p # audit against the spec hint --mode review contracts/nda.md | claude -p

Then just keep talking to your assistant. hint apply writes the HINT workflow into your AGENTS.md and CLAUDE.md — so Claude Code, Codex, and Cursor call hint on their own whenever a matter’s .hint spec is relevant. No need to run it by hand.

HINT compiles prompts; it does not practice law. Every draft is produced for and requires review by licensed counsel — the draft mode footer states this explicitly in its output.

Red lines the AI can't cross.

Declare the deal once. Draft, revise, and audit every document against the same binding specification.