Generated from smart-base/L4/skills/smart-l4/review-decision-support-guidance.md — do not edit here.

✎ Edit this page’s source

Review decision-support guidance

Skill id: review-decision-support-guidance · Package: authoring-who-smart-guidelines · Task Task_Review of act-on-decision-support.bpmn (Process_ActOnDecisionSupport), lane health-worker.

Performed by a person: the health worker, who stays accountable for the care given. Guidance is advice, never an order; declining it is a normal answer, not an exception.

Input and output

The contract is input.schema.json and output.schema.json.

  • In: the guidance, as apply-decision-support returned it (a RequestGroup or RequestOrchestration, or CDS Hooks cards), the subject, and how it is renderedOn.
  • Out: one decisions entry per action: accepted, declined, or modified with the changed resource. An action the health worker did not touch is declined: nothing is carried out on silence. addReason is true only if the health worker tapped “add a reason” (false by default).

The burden is the point

Health workers are overburdened, and this step sits inside their visit.

  • One tap per action: accept or decline. “Accept all” is one tap for the whole proposal.
  • Nothing else is required. A reason is never asked for here; the health worker MAY add one with record-decision-rationale, which runs beside this step and never holds it up.
  • Modify only where the device supports it (a CDS Hooks suggestion, an editable request). It is optional, and a device that cannot offer it offers accept or decline.

Success criteria

  • Every action in the guidance has exactly one decision.
  • The decisions are recorded by who made them and when; nothing in the client’s record has changed yet (the system’s activate-accepted-guidance does that).

Input and output contracts

What this skill takes and gives, as a class diagram drawn from its JSON Schema contracts by the schemas viewer’s own renderer. Each box links to its definition; each type to its specification.

input [1..1]output [1..1]cards [0..*]guidance [1..1]subject [1..1]renderedOn [1..1]by [1..1]decisions [0..*]review-decision-support-guidance«skill»review-decision-support-guidanceinput : ReviewDecisionSupportGuidanceInput [1..1]output : ReviewDecisionSupportGuidanceOutput [1..1]ReviewDecisionSupportGuidanceInput«json-schema»ReviewDecisionSupportGuidanceInputguidance : ReviewDecisionSupportGuidanceInput.guidance [1..1]subject : ReviewDecisionSupportGuidanceInput.subject [1..1]renderedOn : ReviewDecisionSupportGuidanceInput.rendered… [1..1]ReviewDecisionSupportGuidanceInput.guidance.cards«json-schema»ReviewDecisionSupportGuidanceInput.guidance.cardsuuid : string [0..1]summary : string [1..1]detail : string [0..1]indicator : "info" | "warning" | "critical" [1..1]source : object [1..1]suggestions : unknown[] [0..*]ReviewDecisionSupportGuidanceInput.guidance«json-schema»ReviewDecisionSupportGuidanceInput.guidancerequestGroup : object | object [0..1]cards : ReviewDecisionSupportGuidanceInput.guidance.card… [0..*]ReviewDecisionSupportGuidanceInput.subject«json-schema»ReviewDecisionSupportGuidanceInput.subjectreference : string [0..1]display : string [0..1]ReviewDecisionSupportGuidanceInput.renderedOn«json-schema»ReviewDecisionSupportGuidanceInput.renderedOnformFactor : "mobile" | "tablet" | "desktop" [0..1]language : string [0..1]offline : boolean [0..1]ReviewDecisionSupportGuidanceOutput«json-schema»ReviewDecisionSupportGuidanceOutputdecisions : ReviewDecisionSupportGuidanceOutput.decision… [0..*]addReason : boolean [0..1]ReviewDecisionSupportGuidanceOutput.decisions.by«json-schema»ReviewDecisionSupportGuidanceOutput.decisions.byreference : string [0..1]display : string [0..1]ReviewDecisionSupportGuidanceOutput.decisions«json-schema»ReviewDecisionSupportGuidanceOutput.decisionsaction : string [1..1]outcome : "accepted" | "declined" | "modified" [1..1]modified : object [0..1]by : ReviewDecisionSupportGuidanceOutput.decisions.by [1..1]at : string [1..1]

Processes that run this skill

processstep(s) that name it
Act on decision-support guidanceAccept or decline the guidance

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev