Build a production-ready Next.js App Router page for: **AI Task Manager for Nurses** Primary user: SNF nurse (LN/RN/LPN) ## Figma source files — use these for all design decisions Brand Guidelines: https://www.figma.com/design/p75zu8AdqluZ3MKd6zzvwQ/Carebrain-Brand-Guidelines---Lite Design System: https://www.figma.com/design/4L8zHHXaihjF3jmXnErD1H/Carebrain-Design-System--gluestack-ui- Main Design: https://www.figma.com/design/Jh6BdsV98tbFE2tir9CWb7/Carebrain-Design---90- ## Live Design Tokens (fetched from CareBrain Figma) ### Typography Text-black/2xs : 10px: Inter 10px weight-900 Text-hairline/2xs : 10px: Inter 10px weight-100 Text-light/2xs : 10px: Inter 10px weight-300 Text-extrabold/2xs : 10px: Inter 10px weight-800 Text-semibold/2xs : 10px: Inter 10px weight-600 Text-medium/2xs : 10px: Inter 10px weight-500 Text-normal/2xs : 10px: Inter 10px weight-400 Text-bold/2xs : 10px: Inter 10px weight-700 Text-hairline/Text-thin/2xs : 10px: Inter 10px weight-100 Heading/5xl : 60px: Inter 60px weight-700 Text-bold/xs : 12px: Inter 12px weight-700 Text-hairline/Text-thin/3xl : 30px: Inter 30px weight-100 Text-hairline/Text-thin/md : 16px: Inter 16px weight-100 Text-bold/md : 16px: Inter 16px weight-700 Text-medium/lg : 18px: Inter 18px weight-500 Text-light/5xl : 48px: Inter 48px weight-300 Text-light/4xl : 36px: Inter 36px weight-300 Text-light/2xl : 24px: Inter 24px weight-300 Text-light/xs : 12px: Inter 12px weight-300 Text-medium/md : 16px: Inter 16px weight-500 ## Problem this solves SNF nurses—LNs, RNs, LPNs—begin every shift facing a fragmented, manually-assembled picture of what needs to get done. Their task reality is distributed across PCC's UDA portal, the eMAR/eTAR, the orders portal, clinical alerts, and their own mental model of each resident's acuity. There is no single intelligent surface that says: 'Here are the ten things that matter most right now, in the order you should do them.' Instead, nurses tab between modules, filter assessment queues by unit, check for Stop & Watch alerts, watch for order changes, and mentally reconstruct care priorities shift by shift. Agency nurses—who rotate through facilities without deep familiarity—face this cold every single time they badge in. The consequence for the SNF is measurable and compounding. Missed UDA completions before shift end create documentation gaps that cascade into MDS inaccuracy, PDPM underpayment, and F-Tag exposure during DOH surveys. A nurse who doesn't catch that a new antibiotic order was written won't complete the stewardship note, which won't trigger the Coumadin flowsheet, which means the IDT is flying blind on anticoagulation risk at morning meeting. The problem is not that nurses are inattentive—it is that the EHR surfaces tasks passively, requires multi-step navigation to find what's due, and provides no intelligence about what is clinically urgent versus administratively overdue. Why now: CareBrain already sits in the nurse's workflow via the PCC Marketplace integration and real-time transcription pipeline. The infrastructure to detect clinical events—a change-of-condition note, a new order, a vital sign outlier—and generate structured downstream tasks is either in production or one step away in the backlog (PR-44 SBAR, PR-43 Vitals Trends, PR-19 EHR Operator). Competitors like Voize are already shipping shift-handoff intelligence and care-plan gap detection in European markets. Abridge launched a nurse documentation product in May 2026. The window to own the AI-native nursing task layer in SNFs—before it gets bolted onto a facility EHR as a commodity feature—is open but not indefinitely. ## MVP scope (what to build) Build a shift-scoped AI task view for LNs at one or two PCC-integrated CareBrain pilot facilities. At shift start, the nurse sees a unified, prioritized task list pulled from PCC UDA due dates, open clinical alerts (Stop & Watch, Order Alerts), and eMAR/eTAR completion status for their assigned unit. Tasks are sorted by AI-assigned urgency tier (critical / due soon / routine) based on resident acuity signals and due time. When a nurse completes a task in PCC, the CareBrain view updates in near real-time. A secondary capability: when a nurse records a change-of-condition encounter in CareBrain, the system surfaces the downstream documentation tasks triggered by that event (SBAR, eINTERACT form, antibiotic note) with one-tap navigation to the relevant PCC UDA. MVP does not include autonomous task creation, care plan gap detection, or DON-facing analytics. Success bar: two pilot facility nurses using the task view daily and reporting reduced navigation burden at 30 days. ## All user stories — every one must be reflected in the UI 1. As an LN starting my 7am shift, I want to see a prioritized list of assessments, alerts, and tasks due this shift—pulled from PCC UDAs, eMAR, and clinical alerts—so that I don't have to navigate four separate modules to understand what I'm responsible for before morning meeting. 2. As an agency nurse covering an unfamiliar unit, I want AI-generated task guidance that maps to this facility's specific protocols and my assigned residents' acuity, so that I can perform at the same standard as a permanent staff nurse without a lengthy orientation. 3. As an LN documenting a change-of-condition encounter, I want CareBrain to automatically surface the downstream tasks triggered by that event—eINTERACT SBAR, transfer form, antibiotic note, Coumadin flowsheet—so that I don't miss a required documentation step under time pressure. 4. As a DON doing end-of-shift review, I want visibility into which tasks were completed, which are overdue, and which residents have open clinical flags, so that I can intervene before a documentation gap becomes a compliance issue. 5. As an LN managing a high-census unit, I want AI prioritization that weights tasks by clinical urgency—not just due time—so that I handle the highest-risk resident situations before routine administrative documentation. ## Success metrics — design the UI to make these measurable - UDA completion rate before shift end: ≥95% of due UDAs completed before shift handoff for nurses using the AI task manager, vs. facility baseline - Cascaded task capture rate: ≥90% of PCC-triggered downstream documentation tasks (antibiotic notes, eINTERACT SBARs, Coumadin flowsheets) surfaced to the nurse within 5 minutes of triggering event - Nurse-reported time saved per shift: ≥30 minutes per shift saved on task discovery and navigation across PCC modules, validated via survey at 30 and 60 days - Agency nurse ramp time: Agency nurses reach full task completion parity with permanent staff within 1 shift vs. typical 2-3 shift ramp - Daily active usage: ≥80% of enrolled nurses open the task manager at least once per shift within 30 days of activation - MDS-related documentation deficiencies: Measurable reduction in late or missing MDS-linked nursing documentation at pilot facilities within 60 days ## UI spec Design a mobile app screen for CareBrain, an AI platform for skilled nursing facilities. Brand color: deep purple #9333EA. Screen name: 'Shift Task View'. Top header shows 'Good morning, Marcus — 7A Unit' with a shift timer (12h Day Shift). Below: three collapsible urgency sections — CRITICAL (red left border, 2 tasks), DUE SOON (amber left border, 6 tasks), ROUTINE (gray left border, 3 tasks). Each task card shows: task type label (e.g. 'eINTERACT SBAR'), resident name, due time, source badge (UDA / eMAR / Alert), and a completion checkbox. A floating purple alert banner appears at top when a cascade event fires: 'New cascade: antibiotic order for Room 14 — 2 tasks required' with a 'View Tasks' CTA. Bottom nav: Tasks (active), Notes, Residents, Chat. Clean, clinical, mobile-first. ## Design reference Frame: Shift Task View (375×812px, iPhone 14 base). Components: (1) Header bar — nurse name + unit + shift timer, CareBrain purple #9333EA background, white text. (2) Three urgency section headers — CRITICAL (red #DC2626), DUE SOON (amber #D97706), ROUTINE (gray #6B7280) — each collapsible with task count badge. (3) Task Card — left urgency border stripe, task type label (semibold), resident name (regular), due time chip, source badge (UDA/eMAR/Alert), checkbox right-aligned; tapping opens PCC deep link or CareBrain documentation flow. (4) Cascade Alert Banner — full-width, purple background, white text, 'View Tasks' button — appears when a trigger event fires. User action flow: open app → view prioritized task list → tap task → complete in PCC or CareBrain → return to updated list. ## Platform components to reuse - PCC ADT Event Stream (integration): Reuses CareBrain's existing PCC Marketplace integration to receive ADT events (admissions, discharges, transfers) that trigger downstream documentation tasks such as the New Admission Checklist and eINTERACT Transfer Form. - Vitals Trends Signal (PR-43) (data-source): Reuses the Vitals Trends backlog item as a real-time acuity signal feed into the task prioritization model; a resident with a deteriorating vital sign trajectory should elevate associated monitoring tasks to the critical tier. - Change-of-Condition Task Surfacer (pipeline): Extends the Suggested SBAR from Nurse Encounter backlog item (PR-44) — when a nurse records a change-of-condition encounter in CareBrain's transcription pipeline, this pipeline surfaces all eINTERACT-required downstream tasks (SBAR, transfer form, antibiotic note, Coumadin flowsheet) with one-tap navigation to the relevant PCC UDA. - PCC Marketplace API Wrapper (api): Centralizes all PCC Marketplace API calls (UDA schedule, clinical alerts, eMAR status, ADT events, order changes) behind a single internal service layer so individual pipeline and model nodes do not each manage PCC authentication and rate limiting separately. ## New components to build - PCC UDA Schedule Feed (integration): Reads due UDA assessments per nurse unit and shift from the PointClickCare Marketplace API, providing the primary task source for the shift-scoped task view; must surface due dates, assessment type, and resident assignment in near real-time. - PCC Clinical Alert Feed (integration): Ingests active Stop & Watch alerts, Order Alerts, and eINTERACT triggers from PCC for the nurse's assigned unit; these events are the highest-urgency inputs to the task prioritization model. - PCC eMAR/eTAR Completion Status (integration): Polls or subscribes to eMAR and eTAR completion state per shift and unit so the task view can surface outstanding medication and treatment administration records alongside clinical documentation tasks. - Cascade Task Generator (pipeline): Rule-based pipeline that maps clinical trigger events (new antibiotic order, fall note, change-of-condition encounter, ADT event) to the downstream documentation tasks required by PCC protocol — e.g., antibiotic order → stewardship note task, fall → Physical Functioning Monitoring UDA task for three shifts; encodes the trigger-task pairs documented in the PCC knowledge base. - Shift Task Prioritization Model (model): Scores each task by urgency tier (critical / due soon / routine) using inputs including due time, resident acuity signals from PCC, recent vital sign changes (leveraging PR-43 Vitals Trends data), and eINTERACT trigger state; produces the ordered task list the nurse sees at shift start. - Shift Task View (ui-component): Mobile-first nurse-facing screen showing a prioritized, shift-scoped task list segmented by urgency tier; displays task type, resident name, due time, and completion status with real-time updates as tasks are completed in PCC; entry point is the existing CareBrain mobile app. - Cascade Task Alert Panel (ui-component): Inline notification surface within the Shift Task View that appears when a clinical event (new order, fall, change-of-condition) triggers downstream required documentation; lists the triggered tasks with one-tap deep links into the relevant PCC UDA or CareBrain documentation flow. - Shift-Start Task Assembly Workflow (workflow): Orchestrates the end-to-end flow at nurse shift start: authenticate nurse role and unit assignment → query PCC UDA schedule, clinical alerts, and eMAR status → run prioritization model → render Shift Task View; designed to complete within 10 seconds of nurse login so it is usable before morning meeting. - Real-Time Task Completion Sync (workflow): Polls or webhook-subscribes to PCC completion events so that when a nurse marks a UDA done in PCC, the CareBrain Shift Task View updates without requiring manual refresh; prevents the nurse from managing tasks in two places. ## Technical requirements - Next.js App Router page (default export), TypeScript, Tailwind CSS - Use shadcn/ui: Button, Card, Badge, Input, Select, Table, Skeleton, Dialog as needed - Full interactivity: real state, handlers, forms — no placeholder TODOs - Loading state (Skeleton), empty state (with CTA), error state - Hover/focus states on all interactive elements - Mobile-first (sm: breakpoints). Min touch target 44px. - High contrast text (≥4.5:1). SNF clinical context — clarity over decoration. ## Full spec (reference) # PRD: AI Task Manager for Nurses **Status:** DRAFT | **Owner:** CareBrain PM | **Last updated:** 2026-06-11 --- ## TLDR Build a shift-scoped AI task view for SNF nurses that pulls due UDA assessments, clinical alerts, eMAR/eTAR status, and cascade-triggered documentation tasks from PointClickCare into a single prioritized mobile screen—so nurses stop rebuilding their shift picture from five separate PCC modules and start every shift knowing exactly what matters most. --- ## Why Now CareBrain already has a PCC Marketplace integration and a real-time transcription pipeline. The incremental engineering investment to surface nurse task intelligence on top of that foundation is smaller than it appears. Meanwhile, three forces are converging: 1. **Competitors are shipping.** Voize launched a Digital Shift Handover feature aggregating fall status, pending measures, and PRN medications into a mobile shift overview. Abridge launched Abridge for Nurses in May 2026. The AI-native nursing task layer is being claimed—CareBrain should own it in SNFs before it gets commoditized as a PCC Advisor feature. 2. **The regulatory cost of missed tasks is quantified.** Late or missing MDS-linked nursing documentation triggers payment penalties under PDPM. A missed antibiotic stewardship note means the IDT is flying blind on anticoagulation risk. These are not abstract risks—they are F-Tag exposure and dollar losses that DONs can name. 3. **56% of operators cite Medicare Advantage as their top pressure.** Complete, timely nursing documentation is the upstream input to MA authorization success. A task manager that closes documentation gaps before shift end is a direct MA denial-reduction tool. --- ## Problem SNF nurses—LNs, RNs, LPNs—begin every shift without a unified picture of what needs to get done. Their task reality is distributed across PCC's UDA portal, the eMAR/eTAR, the orders portal, and the clinical alerts dashboard. There is no intelligent surface that says: "Here are the ten things that matter most right now, in the order you should do them." Instead, nurses tab between modules, filter assessment queues by unit, watch for Stop & Watch alerts, check for order changes, and mentally reconstruct care priorities shift by shift. Agency nurses face this cold every time they badge in. The consequence is measurable. Missed UDA completions create documentation gaps that cascade into MDS inaccuracy, PDPM underpayment, and F-Tag exposure. A nurse who doesn't catch a new antibiotic order won't complete the stewardship note, which won't trigger the Coumadin flowsheet, which means the IDT lacks anticoagulation context at morning meeting. The EHR surfaces tasks passively and provides no clinical urgency intelligence—only due time. The problem is not nurse inattention. It is that PCC was built to store and retrieve clinical data, not to tell nurses what to do first. --- ## Users | User | Impact | |---|---| | LN / RN / LPN (primary) | Shift task discovery and completion; direct documentation burden reduction | | Agency Nurse | Facility-specific task orientation without lengthy manual onboarding | | DON / ADON | Shift-level completion visibility; compliance risk surface (next-level scope) | | MDS Coordinator | Assessment deadline awareness surfaced alongside daily nursing tasks (next-level) | --- ## Example User Story: Marcus (LN, 12-hour day shift) Marcus is a licensed nurse covering a 24-bed skilled unit at a PCC-integrated SNF. He badges in at 6:55am and has 5 minutes before morning IDT meeting. Today he has 3 admissions, 2 residents with active antibiotic orders, and a change-of-condition note from the night nurse. **Without CareBrain:** Marcus opens PCC, filters the UDA portal by his unit, counts 11 assessments due by 11am, checks the clinical alerts tab, scrolls eMAR for outstanding meds, and tries to hold all of this in his head while walking into morning meeting. **With MVP:** Marcus opens CareBrain on his phone. The Shift Task View loads in under 10 seconds showing 4 critical tasks (including the eINTERACT SBAR triggered by the night nurse's change-of-condition note and two antibiotic stewardship notes), 6 due-soon tasks (UDAs due before 11am), and 3 routine tasks. He taps the SBAR task, which deep-links directly to the relevant PCC UDA. He walks into morning meeting knowing he has not missed anything. --- ## MVP Scope One or two PCC-integrated CareBrain pilot facilities. Scope is deliberately narrow: - **Shift Task View:** Mobile-first screen in the CareBrain app. Prioritized task list segmented into three urgency tiers (Critical / Due Soon / Routine). Each task shows: task type, resident name, due time, source (UDA / eMAR / Alert), completion status. Updates in near-real-time as tasks are completed in PCC. - **Task Sources (MVP):** PCC UDA due assessments by unit and shift, active Stop & Watch and Order Alerts from PCC clinical alert feed, eMAR/eTAR completion status for assigned unit. - **Cascade Task Surfacer:** When a nurse records a change-of-condition encounter in CareBrain's transcription pipeline, the system surfaces all downstream documentation tasks triggered by that event (eINTERACT SBAR, antibiotic note, Coumadin flowsheet, Physical Functioning Monitoring UDA) with one-tap navigation to the relevant PCC UDA. - **Task Prioritization Model (MVP):** Weighted scoring function (not ML). Inputs: due-time bucket, PCC urgency flag, vitals trend tier (PR-43), eINTERACT trigger state. - **Out of scope for MVP:** Autonomous task creation without nurse initiation, DON analytics dashboard, MDS deadline tracking, MA authorization gap alerts, agency nurse mode. **Success bar:** Two pilot facility nurses using the task view daily, reporting reduced navigation burden at 30 days. --- ## Next Level 1. **Agentic Task Creation (PR-19 EHR Operator):** CareBrain monitors PCC state continuously and creates tasks automatically when new orders, ADT events, or MDS deadlines are detected—without nurse initiation. 2. **DON Dashboard:** Shift-level task completion rates, open flags by unit, overdue documentation by resident. Turns the nurse-facing task layer into a nursing operations intelligence tool for administrators. 3. **Agency Nurse Mode:** Role-aware task filtering and facility-specific protocol overlays that surface only the tasks relevant to a float nurse's assignment and skill level. 4. **MDS Deadline Tracker:** Assessment deadlines (5-day, 14-day, 30-day, quarterly) surfaced in the task view for MDS coordinators and IDT members alongside daily nursing tasks. 5. **MA Authorization Gap Alerts:** Flags when a task completion is missing documentation language required for Medicare Advantage prior authorization, directly addressing the 56% of operators citing MA as their top pressure. --- ## Framework Nodes | Node Type | Name | Status | Notes | |---|---|---|---| | Integration | PCC UDA Schedule Feed | New / Next | Due assessments per unit per shift from PCC Marketplace API | | Integration | PCC Clinical Alert Feed | New / Next | Stop & Watch, Order Alerts, eINTERACT triggers | | Integration | PCC eMAR/eTAR Completion Status | New / Next | Medication and treatment admin record completion per shift | | Integration | PCC ADT Event Stream | Reuses pcc-marketplace-integration | Admissions/discharges triggering new admission task cascades | | Pipeline | Cascade Task Generator | New / Next | Rule engine mapping trigger events to downstream required tasks | | Model | Shift Task Prioritization Model | New / Next | Weighted urgency scoring (due time + acuity + vitals + alert state) | | Data Source | Vitals Trends Signal | Reuses PR-43 | Real-time acuity feed into prioritization model | | Pipeline | Change-of-Condition Task Surfacer | Extends PR-44 | Surfaces cascade tasks from nurse encounter transcription | | UI Component | Shift Task View | New / Next | Mobile-first prioritized shift task screen | | UI Component | Cascade Task Alert Panel | New / Next | Inline triggered-task notification with PCC deep links | | Workflow | Shift-Start Task Assembly | New / Next | Authenticates, queries PCC, scores tasks, renders view <10 seconds | | Workflow | Real-Time Task Completion Sync | New / Next | Keeps CareBrain task state in sync with PCC completions | | API | PCC Marketplace API Wrapper | Reuses pcc-marketplace-integration | Centralizes all PCC API calls behind a single internal service | --- ## Success Metrics | Metric | Target | |---|---| | UDA completion rate before shift end | ≥95% of due UDAs completed before shift handoff (vs. facility baseline) | | Cascaded task capture rate | ≥90% of trigger-required tasks surfaced within 5 minutes of triggering event | | Nurse-reported time saved per shift | ≥30 minutes saved on task discovery and PCC navigation | | Agency nurse ramp time | Task completion parity with permanent staff within 1 shift | | Daily active usage | ≥80% of enrolled nurses open the task view at least once per shift within 30 days | | MDS documentation deficiencies | Measurable reduction in late/missing MDS-linked nursing documentation at pilot facilities within 60 days | --- ## Business Goals - **Facility-level seat expansion:** Upsell existing CareBrain scribe customers on a Nursing Intelligence add-on tier ($30–50/nurse/seat/month). Economic justification: one avoided PDPM payment penalty or one MA denial reversed covers months of seat cost. - **Deepen PCC integration lock-in:** Each new PCC data feed (UDA, eMAR, alerts) raises CareBrain's switching cost at the facility level and makes the PCC Marketplace relationship more defensible. - **Broaden CareBrain usage beyond specialty providers:** Moves CareBrain from a physician/NP scribe tool to a facility-wide clinical intelligence platform, accelerating the path to the DON and administrator persona. - **MA denial reduction narrative:** Positions CareBrain as a revenue protection tool for the 56% of operators citing MA as their top pressure—documentation completeness upstream of authorization decisions. --- ## Assumptions | Assumption | Certainty (0–10) | Validation | |---|---|---| | Nurses will adopt CareBrain task view if it genuinely reduces PCC navigation—not if it feels like a second system | 8 | 2-week pilot with 3–5 LNs; measure whether they open the task view at shift start | | PCC Marketplace API provides sufficient real-time access to UDA schedules, alerts, eMAR status, and order events | 6 | API audit sprint before any product code; confirm endpoints, latency, and permission model | | AI urgency prioritization will be trusted more than due-time sort by nurses | 6 | A/B prototype: chronological vs. AI-prioritized; measure high-acuity task completion speed | | Facilities will grant data access permissions without DON/IT resistance given existing PCC Marketplace presence | 7 | Structured discovery call with DON and IT at two current CareBrain PCC customers before MVP build | | Cascade task-trigger rule set can cover ≥80% of real-world trigger-task pairs without facility-by-facility customization | 7 | Map trigger-task pairs from PCC knowledge base against 2–3 live facilities before locking rule engine | | Nurses think in shifts (not days or weeks); shift-scoped MVP framing matches mental model | 8 | Confirm shift structure and mental model in pilot facility discovery interviews | --- ## Open Questions 1. Does the PCC Marketplace API expose UDA due-date schedules as a queryable endpoint, or does CareBrain need to compute due dates from assessment schedule configurations? What is the payload latency? 2. Are Stop & Watch and Order Alert events available as a webhook stream or polling-only in the PCC Marketplace? What is the P95 latency? 3. Does the existing PCC Marketplace partnership agreement cover the new API scopes required (UDA schedule, eMAR status, orders feed), or does this require a contract amendment and PCC approval timeline? 4. How much protocol variation exists in cascade trigger-task mappings across PCC facilities in the current CareBrain customer base—specifically, do antibiotic stewardship note triggers and fall monitoring UDA schedules differ by facility configuration? 5. Should the MVP task view be a dedicated screen in the CareBrain app or an overlay/widget within the existing note-taking workflow? Which reduces friction more for nurses who are already opening CareBrain for documentation? 6. How does the DON want to be notified of shift-end documentation gaps—push notification, daily digest, or an admin dashboard? This shapes next-level scope prioritization. 7. What is the PCC Marketplace review and approval timeline for new API scope requests, and should this be initiated before or in parallel with the MVP build sprint? Deliver a production-grade initial version that engineers can build on directly. Not a wireframe.