note-context

Note Context

Purpose

Establish the documented, cited facts every downstream artefact and the quality-gap check depend on - or, for an unsigned note, stop the whole run and route it back to the clinician.

When to use

Start of every run - triggered by "pull the facts out of today's note", "structure this visit note", "what did the note actually document?", "start the documentation run". Also use it when the note turns out to be unsigned or a draft: this skill owns the halt-and-escalate for rule #5, so it must run so that the halt happens.

When NOT to Use

• Drafting a referral, after-visit summary or care plan - use document-derive instead.
• Explaining whether the note supports a code on the claim - use coding-rationale instead.
• Computing quality-measure status - use quality-gap-check instead.
• Writing a clinician handoff or sign-out note - use handoff-draft instead.
• Summarising a document that is not a clinical encounter note - use the built-in docx skill instead.

Inputs

Encounter note text with its signature line; problem and medication lists; orders and results; the claim block (if any); config/quality-measures.json; base/contracts/hls.clinical-documentation-companion.v1.json.

Steps

1. Confirm the note is signed: an electronic-signature line naming the signer and time, or note_signature.signed == true on a supplied contract. A "draft", "pended" or unsigned note fails this check. If it fails, stop here: write only the halt record (Output Format) and escalate - no encounter, no note_facts (the contract does not require encounter in an unsigned-note halt record).
2. Extract encounter = {patient_id, visit_type, date} from the note header.
3. Build the fact-key list - do not guess key names: a. required_fact_key of every measure in config/quality-measures.json; b. supported_by of every claim.elements[] entry; c. the document-derive facts: referral_indicated, active_medications, patient_instructions, follow_up_plan (one entry each; use the note's own wording in citation.text).
4. For each key write "<fact_key>": {"value": <bool>, "citation": {"source": "<DocumentReference/...>", "locator": "<section, line N>", "text": "<verbatim sentence>"}}. For a single-finding key, quote the sentence that supports the fact, not the whole line. For the document-derive facts in 3c, also write statements[] with one {text, citation} entry for every relevant sentence the note documents - every medication, every instruction, every follow-up item, the referral and its reason - so nothing a downstream draft needs is lost; citation then repeats the first statement's citation. Never paraphrase a finding into existence.
5. When the note is silent on a key, record value: false with locator: "full note reviewed" and text stating the absence - absence is a documented absence, not an omission.
6. If the note's date is not the date the user called "today", say so in one line and use the note's date.
7. Write encounter, note_signature and note_facts to the contract (carry contract_version and claim through unchanged) and hand off to document-derive, coding-rationale and quality-gap-check.