followup-plan

Followup Plan

Action level: L1 (draft for human approval). The checklist is drafted; no appointment, referral or order is booked, sent or closed by this plugin.

Purpose

Give the patient and receiving clinician a concrete, dated action list.

When to use

Last skill in the chain, after the summary and instructions are drafted. Typical triggers: "what follow-up does this patient need", "build the follow-up checklist", "who is chasing the pending labs", "just list the pending potassium recheck".

When NOT to use

When NOT to use: do not use it to reconcile medications (med-reconcile), to write the summary (summary-draft) or the patient sheet (patient-instructions). Do not use it to book an appointment, place a referral, notify a clinician or close a pending result - it drafts the list only; booking goes to the calendar tools with clinician confirmation. Do not use it to produce an item with no order behind it, and do not use it to assign an owner by guesswork when the record names none.

Inputs

encounter; pending_results[] (result, ordered_date, owner, due_date, source_note); referral_orders[]; config/followup-rules.json (required fields, allowed owners, max_days_to_first_followup).

Steps

1. Extract every follow-up appointment, pending result and referral from the encounter into followup_checklist[], keeping the order's source_note so the engine can match each order to its checklist item.
2. Assign an owner drawn from config allowed_owners (patient, receiving clinician, care coordinator).
3. Take the due date from the order and cite the order or result in source_note / documented_date.
4. Run the followup_check engine tool (python3 base/scripts/followup_check.py --question <payload> --config config/followup-rules.json --out <payload>).
5. Resolve every gap in followup_report - or escalate it - before the packet is handed over.

Output

followup_checklist[{item, owner, due_date, source_note, documented_date, category}] on the contract, plus followup_report {items_checked, pending_results_checked, referral_orders_checked, gaps[{subject, type, detail, citation}], complete, citation, config, source} and one escalation per gap. Gap types: missing_field, owner_not_allowed, due_date_out_of_window, due_date_unverifiable (a due date that is not YYYY-MM-DD, or a missing/unreadable discharge date, so the window cannot be checked), untracked_order (a pending result or referral with no checklist item). Maps to the C-CDA Plan of Treatment section (LOINC 18776-5) / FHIR R4 ServiceRequest and DiagnosticReport.