Encore OS — Documentation

Created: 2026-02-08
Author: AI Analysis of all Encore OS module specs

Executive Summary

After analyzing the HR onboarding orchestration gaps, this document examines all other Encore 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 layer
useResidentJourneyStatus(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   │
│                                             │
└─────────────────────────────────────────────┘

This pattern is reusable. Once the HR Onboarding Orchestration is built, the same @/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

HR Onboarding Process Guide
HR Onboarding Orchestration Plan
RH Module README
FA Module README
FM Module README
GR Module README
LO Module README
IT Module README

Last Updated: 2026-02-08

​Executive Summary

​Recommendation Priority Overview

​Recommendation 1: Resident Intake-to-Discharge Journey (RH)

​The Pattern (Same as HR Onboarding)

​Specs Involved

​Gap: No Unified “Resident Journey Dashboard”

​Recommendation

​Why This Is P1

​Recommendation 2: Month-End Close Orchestration (FA)

​The Pattern

​Specs Involved

​Gap: No “Close Cockpit” Tying Steps Together

​Recommendation

​Why This Is P1

​Recommendation 3: Employee Offboarding Orchestration (HR + IT)

​The Pattern

​Specs Involved

​Gap

​Recommendation

​Why This Is P1

​Recommendation 4: New Regulation Compliance Rollout (GR)

​The Pattern

​Specs Involved

​Gap

​Recommendation

​Why This Is P2

​Recommendation 5: New Facility/Site Setup Process (FM + RH + PF)

​The Pattern

​Specs Involved

​Gap

​Recommendation

​Why This Is P2

​Recommendation 6: Quarterly Planning Cycle (LO)

​The Pattern

​Specs Involved

​Gap

​Recommendation

​Why This Is P2

​Recommendation 7: New Grant Setup & Compliance (FA + HR + GR)

​The Pattern

​Specs Involved

​Recommendation

​Why This Is P3

​Recommendation 8: New Staff Onboarding for Housing Operations (RH + HR + GR)

​The Pattern

​Additional Steps Beyond HR-03

​Recommendation

​Why This Is P3

​Summary: Common Pattern Across All Recommendations

​Implementation Sequencing

​Phase A: HR Onboarding (Already Planned, ~4.5 weeks)

​Phase B: P1 Items (~6-8 weeks)

​Phase C: P2 Items (~4-6 weeks)

​Phase D: P3 Items (~2-3 weeks)

​References

Executive Summary

Recommendation Priority Overview

Recommendation 1: Resident Intake-to-Discharge Journey (RH)

The Pattern (Same as HR Onboarding)

Specs Involved

Gap: No Unified “Resident Journey Dashboard”

Recommendation

Why This Is P1

Recommendation 2: Month-End Close Orchestration (FA)

The Pattern

Specs Involved

Gap: No “Close Cockpit” Tying Steps Together

Recommendation

Why This Is P1

Recommendation 3: Employee Offboarding Orchestration (HR + IT)

The Pattern

Specs Involved

Gap

Recommendation

Why This Is P1

Recommendation 4: New Regulation Compliance Rollout (GR)

The Pattern

Specs Involved

Gap

Recommendation

Why This Is P2

Recommendation 5: New Facility/Site Setup Process (FM + RH + PF)

The Pattern

Specs Involved

Gap

Recommendation

Why This Is P2

Recommendation 6: Quarterly Planning Cycle (LO)

The Pattern

Specs Involved

Gap

Recommendation

Why This Is P2

Recommendation 7: New Grant Setup & Compliance (FA + HR + GR)

The Pattern

Specs Involved

Recommendation

Why This Is P3

Recommendation 8: New Staff Onboarding for Housing Operations (RH + HR + GR)

The Pattern

Additional Steps Beyond HR-03

Recommendation

Why This Is P3

Summary: Common Pattern Across All Recommendations

Implementation Sequencing

Phase A: HR Onboarding (Already Planned, ~4.5 weeks)

Phase B: P1 Items (~6-8 weeks)

Phase C: P2 Items (~4-6 weeks)

Phase D: P3 Items (~2-3 weeks)

References