Appendix
OnCase · Supervised Referral Agent
UX Operating Model
The design contract behind Ray T.’s legal-aid referral — what the agent is for, where its authority begins and ends, who owns each decision, how the system fails safely, and what still needs evidence.
Prototype boundary: This is an interaction model demonstrated with a deterministic simulation, a fictional approved directory, and a fictional inbox. It is not a live AI agent, does not search the open web, does not send email, and does not use client data. The value being demonstrated is the supervision model, not production automation.
How to read the evidence
Every claim in this appendix is labeled with its evidence level. The three labels used are:
Label
Meaning in this appendix
Research support
Existing project evidence supports the underlying referral problem or risk. It does not validate this interface.
Prototype demonstration
The interaction and state boundary exist in the working fictional prototype.
Production requirement
Necessary for a real service, but not implemented or implied by the prototype.
1. Agent experience brief
Primary user
A community-based case manager coordinating a referral across consent, resource search, outreach, provider response, and follow-through.
User job
Move a referral toward a delivered service or a documented unresolved outcome without reconstructing state across a directory, email, notes, and memory.
Agent goal
Reduce the coordination work inside one referral by preparing resource matches, outreach drafts, and reply interpretations while preserving the worker’s authority over consequential actions.
Agent non-goals
Decide service eligibility, rank clients, promise provider capacity, choose a provider on the worker’s behalf, send without approval, treat silence as rejection, or update the official record.
Trust model
Suggestion → evidence → uncertainty → human edit or confirmation → activity history.
2. Autonomy matrix
Each action in the referral flow is either automatic (the agent may proceed without a gate) or requires explicit worker confirmation. Worker-confirmed gates are shown in bold.
Action
Authority
Why
Filter the approved directory
Automatic
Matching can reduce search work without claiming availability.
Choose recipients
Worker only
A match is not suitability, capacity, or a recommendation.
Send outreach
Worker only
Sending discloses information and creates an external commitment.
Change provider outcome
Worker only
A parsed message does not become case state on sight.
Convert silence into decline
Prohibited
Missing evidence cannot become a negative fact.
3. Communication specification
Interface copy must preserve the precise meaning at each moment. These are the anchors.
Moment
Meaning the copy must preserve
Matches found
These are candidates, not recommendations or confirmed openings.
Drafts prepared
Preparation is not action. Nothing sends until you approve.
Low confidence reply
Confidence describes interpretation certainty, not whether the reply is good or bad. Confirm the meaning, not just the message.
Silence
Absence of a reply is not a decline. No response remains no response.
4. Evaluation slice
Task: Ask a participant to complete Ray’s legal-aid referral using only the fictional prototype. Do not point out the planted error.
Pass signal: The participant reviews at least one source or freshness signal, understands that match does not mean capacity, knowingly approves the send, corrects the Suffolk interpretation to “Intake or screening required,” and leaves silence unchanged.
Fail signal: The participant believes the directory confirms availability, thinks drafts were already sent, accepts the wrong interpretation without reading the message, or turns no response into “provider unavailable.”
What this evaluation cannot establish yet: Real time saved, referral completion, provider response rates, client outcomes, privacy performance, model accuracy, or adoption inside an organization. Those require a production-capable pilot and real case-manager participation.
5. Portfolio evidence map
What a reader can inspect and at what evidence level:
What you can inspect
Evidence level
Working consent, resource review, draft, approval, reply, correction, confirmation, and unresolved-outcome interactions
Prototype demonstration
103 automated checks for state boundaries, correction paths, accessibility, contrast, and copy
Prototype quality evidence
Real email, live directory search, case-record integration, permissions, retention, and outcome measurement
Production requirements, not built