About this work

Purpose
Structure and route a referral — capturing the referrer and patient details, the referral destination, urgency, reason and history, examination and investigation findings, medications and allergies, and the patient's expectations, consent, and safety-netting — into a completeness status, a completeness percentage, an echoed urgency classification (routine, urgent, two-week-wait suspected cancer, or emergency), mandatory-field results, and flags — not a clinical score. It checks the letter, not the patient.
Specification
Spec-driven: the living domain spec defines the data model, the urgency-dependent mandatory-field completeness rules, the urgency classification, and the flag rules. The same engine grades both the form and the dashboard.
Documentation
Grounded in the NHS e-Referral Service standards and NICE NG12 (suspected cancer). The urgency is always echoed — even for an incomplete referral — so the correct pathway is never hidden. Consent follows Montgomery v Lanarkshire Health Board (2015).