Skill Tracer
Skills › Scientific Agent Skills › treatment-plans › shared_decision_handoff.md

shared_decision_handoff.md

140 lines · skills/treatment-plans/references/shared_decision_handoff.md at 5f2bc03

Open on GitHub
1# Shared Decisions, Informed Preferences, and Handoffs
2
3Last reviewed: **2026-10-01**
4

Shared Decisions, Informed Preferences, and Handoffs

Last reviewed: 2026-10-01

Raw lines 1 to 4
5## Documentation-only role
6
7AHRQ describes shared decision-making as a clinician-led process that explores options, benefits, harms, risks, and what matters to the person. NICE similarly describes healthcare professionals and people working together on treatment and care decisions and communicating risks, benefits, and consequences.
8
9NICE NG197 addresses adults and excludes unexpected emergencies requiring immediate life-saving care and decisions when an adult lacks capacity at the relevant time; separate local processes apply.
11This skill records that process after it occurred. It does not conduct the conversation, generate options, quantify risks, assess capacity, obtain consent, or decide the outcome.

Documentation-only role

AHRQ describes shared decision-making as a clinician-led process that explores options, benefits, harms, risks, and what matters to the person. NICE similarly describes healthcare professionals and people working together on treatment and care decisions and communicating risks, benefits, and consequences.

NICE NG197 addresses adults and excludes unexpected emergencies requiring immediate life-saving care and decisions when an adult lacks capacity at the relevant time; separate local processes apply.

This skill records that process after it occurred. It does not conduct the conversation, generate options, quantify risks, assess capacity, obtain consent, or decide the outcome.

Raw lines 5 to 12
13## Shared-decision record
15For each decision, the authorized clinician supplies:
17- the decision topic;
18- options actually presented;
19- source facts for each option;
20- whether benefits, harms, and uncertainty were discussed;
21- the preference as documented;
22- the agreed or clinician-recorded outcome;
23- participant roles;
24- author role and time;
25- acknowledgment status.
27Use the person's words only when necessary and permitted. Prefer a bounded structured summary over copied narrative.
29Do not:
31- add an option the clinician did not document;
32- characterize an option as preferred, safer, better, first-line, standard, or equivalent;
33- calculate or restate probabilities;
34- infer preference from adherence, demographics, prior care, or silence;
35- treat a checked box as proof of understanding, voluntariness, capacity, or informed consent;
36- create a consent form or legal attestation.

Shared-decision record

For each decision, the authorized clinician supplies:

  • the decision topic;
  • options actually presented;
  • source facts for each option;
  • whether benefits, harms, and uncertainty were discussed;
  • the preference as documented;
  • the agreed or clinician-recorded outcome;
  • participant roles;
  • author role and time;
  • acknowledgment status.

Use the person's words only when necessary and permitted. Prefer a bounded structured summary over copied narrative.

Do not:

  • add an option the clinician did not document;
  • characterize an option as preferred, safer, better, first-line, standard, or equivalent;
  • calculate or restate probabilities;
  • infer preference from adherence, demographics, prior care, or silence;
  • treat a checked box as proof of understanding, voluntariness, capacity, or informed consent;
  • create a consent form or legal attestation.
Raw lines 13 to 37
38## Informed preference versus informed consent
40The template documents an informed preference and shared-decision process. It does not replace:
42- jurisdiction-specific informed-consent requirements;
43- procedure- or product-specific consent;
44- capacity evaluation;
45- surrogate or guardian authority review;
46- language-access or accessibility requirements;
47- research consent;
48- local refusal or declination documentation.
50The authorized local team decides which separate records are required.

Informed preference versus informed consent

The template documents an informed preference and shared-decision process. It does not replace:

  • jurisdiction-specific informed-consent requirements;
  • procedure- or product-specific consent;
  • capacity evaluation;
  • surrogate or guardian authority review;
  • language-access or accessibility requirements;
  • research consent;
  • local refusal or declination documentation.

The authorized local team decides which separate records are required.

Raw lines 38 to 51
52## Communication quality
54The record may note whether the clinician documented:
56- benefits, harms, and material uncertainty;
57- alternatives, including no action, when actually discussed;
58- questions and responses;
59- language, interpreter, communication, or accessibility support;
60- decision aid identity and version;
61- need for revisiting the decision.
63Do not infer quality from presence alone. Do not score the conversation.

Communication quality

The record may note whether the clinician documented:

  • benefits, harms, and material uncertainty;
  • alternatives, including no action, when actually discussed;
  • questions and responses;
  • language, interpreter, communication, or accessibility support;
  • decision aid identity and version;
  • need for revisiting the decision.

Do not infer quality from presence alone. Do not score the conversation.

Raw lines 52 to 64
65## Transition handoff
67WHO transition guidance supports timely, accurate information transfer, medication reconciliation, patient/carer involvement, clear ownership, standardized processes, checklists, and tracking.
69A handoff record should identify:
71- sending and receiving settings and responsible roles;
72- exact handoff date supplied by the clinical team;
73- source records and their versions;
74- interventions, goals, monitoring, checkpoints, and pending results that were actually supplied;
75- ownership of each item;
76- reconciliation status;
77- unresolved items and route;
78- sender and recipient acknowledgment;
79- local follow-up and escalation references.
81The skill does not decide which clinical items are important enough to hand off. The responsible clinicians do.

Transition handoff

WHO transition guidance supports timely, accurate information transfer, medication reconciliation, patient/carer involvement, clear ownership, standardized processes, checklists, and tracking.

A handoff record should identify:

  • sending and receiving settings and responsible roles;
  • exact handoff date supplied by the clinical team;
  • source records and their versions;
  • interventions, goals, monitoring, checkpoints, and pending results that were actually supplied;
  • ownership of each item;
  • reconciliation status;
  • unresolved items and route;
  • sender and recipient acknowledgment;
  • local follow-up and escalation references.

The skill does not decide which clinical items are important enough to hand off. The responsible clinicians do.

Raw lines 65 to 82
83## Medication reconciliation boundary
85Medication reconciliation is a clinical process, not a list-diff script. The authorized team must obtain and compare the relevant lists, make clinical decisions about discrepancies, communicate the result, and document completion in approved systems.
87This package may record:
89- source-list fact IDs;
90- destination-list fact IDs;
91- `pending_authorized_review`, `completed_by_authorized_clinician`, or `not_applicable_by_authorized_clinician`;
92- discrepancy status;
93- reviewer role and completion time.
95It must not:
97- parse medication text to normalize products;
98- identify duplicates, interactions, contraindications, omissions, or dose differences;
99- decide which list is correct;
100- propose changes;
101- mark reconciliation complete automatically.
103If a discrepancy is detected outside the authorized clinical workflow, leave it unresolved and route it to the named medication-reconciliation owner.

Medication reconciliation boundary

Medication reconciliation is a clinical process, not a list-diff script. The authorized team must obtain and compare the relevant lists, make clinical decisions about discrepancies, communicate the result, and document completion in approved systems.

This package may record:

  • source-list fact IDs;
  • destination-list fact IDs;
  • pending_authorized_review, completed_by_authorized_clinician, or not_applicable_by_authorized_clinician;
  • discrepancy status;
  • reviewer role and completion time.

It must not:

  • parse medication text to normalize products;
  • identify duplicates, interactions, contraindications, omissions, or dose differences;
  • decide which list is correct;
  • propose changes;
  • mark reconciliation complete automatically.

If a discrepancy is detected outside the authorized clinical workflow, leave it unresolved and route it to the named medication-reconciliation owner.

Raw lines 83 to 104
105## Pending and unresolved items
107Every unresolved item needs:
109- a stable item ID;
110- a bounded description supplied by the local team;
111- source-fact references;
112- responsible local role;
113- route status.
115An item may be `open_routed`, `acknowledged_by_owner`, or `resolved_by_authorized_professional`. The skill never selects the owner or resolution.

Pending and unresolved items

Every unresolved item needs:

  • a stable item ID;
  • a bounded description supplied by the local team;
  • source-fact references;
  • responsible local role;
  • route status.

An item may be open_routed, acknowledged_by_owner, or resolved_by_authorized_professional. The skill never selects the owner or resolution.

Raw lines 105 to 116
117## Emergency routing
119Do not include generated warning signs, thresholds, destinations, emergency numbers, or instructions.
121Record only:
123> If a concern may be urgent or emergent, stop this documentation workflow and use the institution's current clinical escalation or emergency process; this package does not determine urgency or provide emergency instructions.
125The authorized institution supplies and verifies the local process reference.

Emergency routing

Do not include generated warning signs, thresholds, destinations, emergency numbers, or instructions.

Record only:

If a concern may be urgent or emergent, stop this documentation workflow and use the institution's current clinical escalation or emergency process; this package does not determine urgency or provide emergency instructions.

The authorized institution supplies and verifies the local process reference.

Raw lines 117 to 126
127## Handoff release
129Before authorized documentation handoff:
131- source and destination roles are named;
132- all included items link to verified facts;
133- reconciliation status is verified;
134- unresolved items are routed;
135- the recipient acknowledgment is complete;
136- privacy and local governance checks pass;
137- the clinician sign-off is complete;
138- the release gate has no blocker codes.
140These gates document process completion. They do not prove safe care, successful communication, or recipient action.

Handoff release

Before authorized documentation handoff:

  • source and destination roles are named;
  • all included items link to verified facts;
  • reconciliation status is verified;
  • unresolved items are routed;
  • the recipient acknowledgment is complete;
  • privacy and local governance checks pass;
  • the clinician sign-off is complete;
  • the release gate has no blocker codes.

These gates document process completion. They do not prove safe care, successful communication, or recipient action.

Raw lines 127 to 140