Summary

Sam identified that Current Treatment Plan is a disorganized mess and should become cleaner with roadmaps. I treated this as a workflow redesign, not another text cleanup.

Live validation confirmed the core issue: litify_pm__Matter__c.Current_Treatment_Plan__c is only Text(255), and real values mix provider names, cadence, MRI status, referral status, appointment reminders, release/waiting status, and vague notes. Providers_Seen__c is also only Text(255), so it should not be the durable source of truth either.

Live org findings

Recommended design

Build a Matter-first Treatment_Roadmap_Item__c child object. Each row should represent one treatment roadmap item with selected provider Account, provider Role, treatment type, treatment stage, treatment status, cadence, last and next appointment dates, primary flag, records-needed flag, linked Request, source, confidence, and notes.

Then make Current_Treatment_Plan__c a generated summary snapshot, not the source of truth. Example snapshot: Primary: ExactaCare PT active 1x/week; Aptiva ortho scheduled; MRI completed.

Snapshot rules should exclude ER when active follow-up care exists, show no more than three active/scheduled roadmap items, and stay under 255 characters.

Implementation plan

Saved plan: /Users/samaguiar/Documents/Projects/docs/superpowers/plans/2026-05-26-litify-treatment-roadmap.md

The plan includes metadata scaffolding, field design, draft Requests-tab automation, Matter snapshot automation, staff Screen Flow, migration candidate export, and QA checklist.

Reason for ending

This session ended at live-validated design and implementation planning. I did not deploy Litify configuration because this changes staff workflow and should go through a check-only deployment plus approval before production activation.