Documentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
Version: 1.0.0
Created: 2026-02-08
Author: AI Analysis of all Encore Health OS module specs
Executive Summary
After analyzing the HR onboarding orchestration gaps, this document examines all other Encore Health OS modules for similar opportunities where existing specs are comprehensive but lack orchestrated, guided processes that tie multiple features together into cohesive user journeys.
The HR onboarding analysis found that individual specs were strong, but the “glue” between them was missing. The same pattern exists across the platform.
Recommendation Priority Overview
| # | Module(s) | Guided Process | Impact | Effort | Priority |
|---|
| 1 | RH | Resident Intake-to-Discharge Journey | Critical | Medium | P1 |
| 2 | FA | Month-End Close Orchestration | High | Medium | P1 |
| 3 | HR + IT | Employee Offboarding Orchestration | High | Low | P1 |
| 4 | GR | New Regulation Compliance Rollout | Medium | Medium | P2 |
| 5 | FM | New Facility/Site Setup Process | Medium | Medium | P2 |
| 6 | LO | Quarterly Planning Cycle (EOS L10) | Medium | Low | P2 |
| 7 | FA + HR | New Grant Setup & Compliance | Medium | Medium | P3 |
| 8 | RH + HR + GR | New Staff Onboarding for Housing Operations | Medium | Low | P3 |
Recommendation 1: Resident Intake-to-Discharge Journey (RH)
The Pattern (Same as HR Onboarding)
Recovery Housing has strong individual specs (RH-01 through RH-07), but a resident’s journey from intake to discharge to alumni follow-up touches ALL of them. There is no unified view for either the House Manager (admin side) or the Resident (if self-service were added).
Specs Involved
| Phase | Spec | What Happens |
|---|
| Pre-Admission | RH-01 | Eligibility screening, waitlist management |
| Admission | RH-01 | Episode creation, bed assignment, agreement signing |
| Program Entry | RH-02 | Phase 1 assignment, milestone setup, privilege tracking |
| Daily Operations | RH-04 | Attendance tracking, house meetings, chores, transport |
| Safety/Compliance | RH-03 | UDS testing, safety events, medication audits, pass management |
| Phase Progression | RH-02 | Phase 1 → 2 → 3, milestone completion, privilege advancement |
| Discharge Planning | RH-05 | Initiated 30 days before discharge, resource referrals, aftercare |
| Discharge | RH-01 + RH-05 | Bed released, documentation, discharge summary |
| Post-Discharge | RH-05 + RH-07 | 7/30/90/180/365-day follow-ups, outcomes measurement |
| Alumni | RH-07 | Alumni engagement, mentoring, reporting |
Gap: No Unified “Resident Journey Dashboard”
For House Managers: No single screen showing a resident’s complete status across all modules:
- Where are they in their program phases? (RH-02)
- Are they attending required activities? (RH-04)
- Any safety events or incidents? (RH-03)
- When does discharge planning need to start? (RH-05)
- What’s their UDS testing status? (RH-03)
- Overall compliance score?
For Program Managers: No aggregate view showing all residents’ journey progress:
- Who is at risk of discharge (attendance issues, safety events)?
- Who is approaching phase transitions?
- Who needs discharge planning initiated?
- What’s the overall program completion rate?
Recommendation
Create a Resident Journey Dashboard (similar concept to the HR Welcome Hub/Command Center):
@/platform/resident-journey integration layeruseResidentJourneyStatus(residentId, episodeId) hook aggregating RH-01 through RH-07- House Manager view: unified resident status page
- Program Manager view: cohort progress dashboard
- Automated alerts: approaching phase transition, discharge planning due, follow-up overdue
Why This Is P1
Recovery Housing is the core business domain. A resident falling through the cracks due to fragmented tracking directly impacts outcomes and compliance. This is the RH equivalent of the HR onboarding problem.
Recommendation 2: Month-End Close Orchestration (FA)
The Pattern
FA-19 (Financial Close Management) exists as a spec for managing close checklists, but the actual month-end close process touches nearly every FA module. Today, the close process requires a finance team member to navigate across GL, AP, AR, bank rec, and reporting screens.
Specs Involved
| Close Step | Spec | What Happens |
|---|
| Pre-Close | FA-02 | Review unposted journal entries, post accruals |
| AP Close | FA-03 | Process remaining invoices, verify AP aging |
| AR Close | FA-05 | Apply payments, review AR aging, write-off bad debt |
| Bank Rec | FA-06 | Reconcile all bank accounts for the period |
| Fixed Assets | FA-11 | Run depreciation, review asset disposals |
| Budget vs Actual | FA-08 | Generate budget variance reports |
| Cost Allocation | FA-15 | Run indirect cost allocations |
| Revenue Recognition | FA-18 | Recognize deferred/earned revenue |
| Financial Reporting | FA-07 | Generate trial balance, P&L, balance sheet |
| Close Period | FA-19 | Lock period, approve, archive |
Gap: No “Close Cockpit” Tying Steps Together
FA-19 provides checklist management but does NOT automatically:
- Show status of AP/AR close from FA-03/FA-05
- Verify bank reconciliation is complete (FA-06)
- Confirm depreciation has been run (FA-11)
- Check that all journal entries are posted (FA-02)
- Validate budget vs actual is generated (FA-08)
Recommendation
Create a Financial Close Cockpit that orchestrates across FA modules:
@/platform/financial-close integration layer (or enhancement to FA-19)useCloseReadinessStatus(periodId) hook that checks each module’s close status- Visual close progress tracker: each step shows green/yellow/red
- Blocking logic: cannot lock period until all prerequisite steps are complete
- Auto-generate close checklist tasks from module statuses
Why This Is P1
Month-end close is a recurring, high-stakes process. Missing a step leads to incorrect financials, audit findings, and compliance issues. This directly affects trust in the platform for finance teams.
Recommendation 3: Employee Offboarding Orchestration (HR + IT)
The Pattern
HR-03 has offboarding templates and IT-08 has IT offboarding workflows, but the full offboarding process crosses HR, IT, FM (equipment/badge return), and FA (final paycheck, benefits termination).
Specs Involved
| Step | Spec | What Happens |
|---|
| Initiate | HR-03 | Offboarding instance created, tasks assigned |
| Access Revocation | IT-08 | Disable email, system access, SSO |
| Asset Recovery | IT-08 + FM | Collect laptop, phone, badge, keys |
| Final Paycheck | HR-07 | Calculate final pay, unused PTO payout |
| Benefits Termination | HR-11 | Terminate enrollments, trigger COBRA |
| Knowledge Transfer | HR-03 | Document handoff, reassign responsibilities |
| Exit Interview | HR-03 + HR-17 | Conduct exit interview, record feedback |
| Credential Deactivation | HR-02 | Mark credentials as inactive |
| Compliance | GR | Ensure all compliance items closed |
Gap
Same problem as onboarding: HR must check multiple screens. IT doesn’t know if the final paycheck is done. FM doesn’t know if IT has collected the laptop. No unified “this person is fully offboarded” confirmation.
Recommendation
Create an Offboarding Command Center (mirror of the Onboarding Command Center):
useOffboardingStatus(employeeId) hook aggregating HR-03, IT-08, HR-07, HR-11- Unified checklist showing all module statuses
- Critical path: access revocation must happen within 2 hours (SLA tracking)
- “Fully Offboarded” confirmation only when all modules confirm completion
Why This Is P1
Security risk. A terminated employee retaining system access is a compliance and security failure. This process needs the most orchestration urgency.
Recommendation 4: New Regulation Compliance Rollout (GR)
The Pattern
When a new regulation or policy requirement hits (e.g., new HIPAA rule, new state licensing requirement), GR needs to coordinate across multiple modules: update policies (GR-01), schedule training (GR-02), update compliance checklists (GR-03), update risk assessments (GR-05), and potentially update HR credentialing requirements (HR-02).
Specs Involved
| Step | Spec | What Happens |
|---|
| Identify | GR-03 | New requirement identified and documented |
| Risk Assessment | GR-05 | Assess risk of non-compliance |
| Policy Update | GR-01 | Create/update affected policies |
| Training | GR-02 | Create training materials, assign to staff |
| Compliance Tracking | GR-03 | Create compliance checklist items |
| Credential Updates | HR-02 | Update required credentials per position (if applicable) |
| Audit Prep | GR-04 | Document compliance evidence |
| Monitoring | GR-07 | Track ongoing compliance |
Gap
No guided workflow for “we need to comply with X by date Y.” The compliance officer must manually navigate each module to ensure all steps are covered.
Recommendation
Create a Compliance Rollout Wizard or guided checklist:
- Input: regulation name, effective date, affected areas
- Auto-generates: tasks across GR-01 through GR-05
- Dashboard: rollout progress with deadline tracking
- Integration with HR-02 if credential requirements change
Why This Is P2
Important but less frequent than P1 items. New regulations don’t happen daily, but when they do, a missed step has significant consequences.
Recommendation 5: New Facility/Site Setup Process (FM + RH + PF)
The Pattern
When the organization opens a new residential facility or office location, multiple modules need configuration: PF site setup, RH residence and bed inventory, FM asset registration, IT equipment deployment, HR staff scheduling, and GR compliance setup.
Specs Involved
| Step | Module | What Happens |
|---|
| Site Creation | PF-01 | Create site record in platform |
| Residence Setup | RH-01 | Create residence, define beds, set NARR level |
| Asset Registration | FM-05 | Register building systems, HVAC, fire safety |
| PM Scheduling | FM-04 | Set up preventive maintenance for all assets |
| Inspection Setup | FM-06 | Schedule initial inspections |
| Staff Assignment | HR-04 | Assign staff to new site |
| Compliance Setup | GR-03 | Set up compliance requirements for site |
| IT Infrastructure | IT-01 | Register IT assets, network setup |
Gap
No guided “open a new site” process. Each team does their setup independently, leading to things being missed (e.g., FM never sets up PM schedules, GR compliance requirements aren’t configured).
Recommendation
Create a New Site Setup Wizard (using PF-41 Module Wizard framework):
- Multi-step guided process covering all modules
- Assigns tasks to appropriate teams (FM, HR, IT, GR)
- Tracks completion across all modules
- “Site Ready” confirmation when all prerequisites met
Why This Is P2
Infrequent but high-impact. Opening a new site without proper setup leads to compliance gaps, safety risks, and operational issues.
Recommendation 6: Quarterly Planning Cycle (LO)
The Pattern
The EOS Level 10 meeting cycle (LO-06) drives quarterly planning where Rocks are set (LO-03), scorecards updated (LO-05), issues resolved (LO-07), and to-dos created (LO-04). While each spec works independently, the quarterly transition (closing one quarter, opening the next) involves touching all of them.
Specs Involved
| Step | Spec | What Happens |
|---|
| Quarterly Review | LO-06 | Annual/quarterly planning meeting |
| Rock Completion | LO-03 | Review and close current quarter rocks |
| Rock Setting | LO-03 | Set new quarter rocks aligned to V/TO |
| Scorecard Update | LO-05 | Archive previous quarter, set new targets |
| Issue Carryover | LO-07 | Review open issues, carry forward or close |
| To-Do Cleanup | LO-04 | Close completed, carry forward active |
| Goal Alignment | LO-11 | Cascade goals to team members |
| Accountability | LO-02 | Update accountability chart if roles changed |
Gap
No “Quarterly Transition” guided process. Leaders must manually close rocks, set new ones, update scorecards, and clean up issues across separate screens.
Recommendation
Create a Quarterly Transition Wizard:
- Guided 5-step process: Review Rocks → Set New Rocks → Update Scorecards → Resolve Issues → Confirm
- Auto-carries forward incomplete rocks with option to modify
- Archives previous quarter data
- Generates quarterly summary report
Why This Is P2
Happens 4x per year. Not urgent but directly impacts strategic execution quality. Low effort since it mostly orchestrates existing CRUD operations.
Recommendation 7: New Grant Setup & Compliance (FA + HR + GR)
The Pattern
Healthcare organizations frequently receive grants (government, foundation). A new grant requires setup in FA (project accounting, budget, cost allocation), HR (staff cost allocation), and GR (compliance tracking, reporting requirements).
Specs Involved
| Step | Spec | What Happens |
|---|
| Grant Record | FA-13 | Create project/grant record |
| Budget Setup | FA-08 | Create grant budget |
| Cost Allocation | FA-15 | Configure indirect cost rate for grant |
| Chart of Accounts | FA-01 | Add grant-specific accounts if needed |
| Staff Assignment | HR (labor) | Allocate staff time to grant |
| Compliance | GR-03 | Track grant-specific compliance requirements |
| Reporting | FA-07 + FA-13 | Configure grant financial reports |
Recommendation
Create a New Grant Setup Wizard that walks through all required configuration across FA and GR modules. This is a natural fit for the PF-41 Module Wizard framework.
Why This Is P3
Grants are important but vary significantly in requirements. A flexible wizard with optional steps would be most valuable. Lower frequency than P1/P2 items.
Recommendation 8: New Staff Onboarding for Housing Operations (RH + HR + GR)
The Pattern
When a new staff member (house manager, housing tech) is hired for recovery housing operations, their onboarding extends beyond standard HR onboarding (HR-03) to include RH-specific training and GR compliance.
Additional Steps Beyond HR-03
| Step | Module | What Happens |
|---|
| Standard HR Onboarding | HR-03 | Normal employee onboarding flow |
| Site Assignment | HR-01 + RH-01 | Assign to specific residence(s) |
| RH Training | GR-02 | Recovery housing specific training (NARR, trauma-informed) |
| Clinical Oversight | HR-19 | Set up supervisor relationship (for BHT/BHPP) |
| System Access | IT-08 | RH module access provisioning |
| Credential Verification | HR-02 | Healthcare-specific credential verification |
| Compliance Orientation | GR-03 | Site-specific compliance requirements |
Recommendation
Extend the HR Onboarding Orchestration (already planned) with an RH-specific template preset that includes:
- Recovery housing training tasks
- Site assignment task
- Clinical oversight setup (if applicable)
- RH-specific compliance orientation
This could be implemented as a “Clinical/Housing Role” preset in the HR Onboarding Template Presets (T14 in the onboarding orchestration tasks).
Why This Is P3
Naturally extends the HR onboarding work already planned. Low incremental effort since it’s adding a template preset, not building new infrastructure.
Summary: Common Pattern Across All Recommendations
Every recommendation follows the same architectural pattern:
┌─────────────────────────────────────────────┐
│ ORCHESTRATION PATTERN │
├─────────────────────────────────────────────┤
│ │
│ 1. Platform Integration Layer │
│ @/platform/{process-name} │
│ - useProcessStatus() hook │
│ - computeProcessProgress() function │
│ │
│ 2. Admin Dashboard/Command Center │
│ - Unified status view across modules │
│ - Quick actions for common tasks │
│ - Alert/risk indicators │
│ │
│ 3. User-Facing Guided Experience │
│ - Step-by-step process (wizard or hub) │
│ - Progress tracking │
│ - Context-appropriate help content │
│ │
│ 4. Cross-Module Integration │
│ - Auto-creation of tasks in other mods │
│ - Status aggregation from all sources │
│ - Deadline tracking and notifications │
│ │
└─────────────────────────────────────────────┘
@/platform/ integration pattern can be applied to all other recommendations with decreasing effort (the architecture is proven).
Implementation Sequencing
Phase A: HR Onboarding (Already Planned, ~4.5 weeks)
- Establishes the pattern
- Proves the architecture
- Highest organizational impact (every employee goes through onboarding)
Phase B: P1 Items (~6-8 weeks)
- Employee Offboarding (~2 weeks) — mirrors onboarding pattern, security-critical
- Resident Journey Dashboard (~3-4 weeks) — core business domain
- Financial Close Cockpit (~2-3 weeks) — recurring high-stakes process
Phase C: P2 Items (~4-6 weeks)
- Compliance Rollout Wizard (~2 weeks)
- New Site Setup Wizard (~2 weeks)
- Quarterly Transition Wizard (~1-2 weeks)
Phase D: P3 Items (~2-3 weeks)
- Grant Setup Wizard (~1-2 weeks)
- RH Staff Onboarding Preset (~3-5 days, extends HR work)
References
Last Updated: 2026-02-08
