Encore OS — Documentation

Overview

This guide covers administration of the AI Compliance Advisor feature, including enabling AI, managing suggestions, reviewing AI outputs, and configuring settings.

Enabling AI Features

Prerequisites

Organization administrator or compliance officer role
Access to GR module settings

Default State

The AI Compliance Advisor is enabled by default for every organization as of June 12, 2026. You do not need to opt in. The four GR AI surfaces (gap analysis, audit preparation, AI suggestions, AI prompts) render automatically once a user has the right module permissions. Skip to Managing AI Suggestions unless you need to turn the advisor off.

Re-enable AI for Your Organization

If a previous admin disabled the advisor and you want it back:

Navigate to GR → Settings

Click the AI tab

Toggle Enable AI Compliance Advisor to ON

Click Save Changes

Once enabled, AI features will be available to all GR module users.

Disable AI Features

To disable AI for your organization:

Navigate to GR → Settings → AI

Toggle Enable AI Compliance Advisor to OFF

Click Save Changes

Note: Disabling AI does not delete existing AI-generated data. Users will retain access to previously generated suggestions.

Managing AI Suggestions

Review Workflow

As a compliance officer, you are responsible for reviewing AI-generated suggestions before they are implemented. Review Process:

Navigate to GR → AI → Suggestions

Filter by Status: Pending to see unreviewed suggestions

Click on a suggestion to review details

Take action:

Accept: Marks suggestion as approved, may create related records
Reject: Dismisses suggestion with a documented reason
Defer: Saves for later review

Bulk Actions

For multiple suggestions:

Select suggestions using checkboxes
Use bulk action buttons:
- Accept Selected
- Reject Selected (prompts for reason)

Suggestion Lifecycle

AI Generated → Pending → Review
                           ↓
                    ┌──────┴──────┐
                    ↓             ↓
               Accepted       Rejected
                    ↓
               Implemented

Reviewing AI Gap Analyses

Gap Analysis Workflow

Generate: User or scheduled job triggers gap analysis

Review: Compliance officer reviews findings

Validate: Confirm or adjust gap severity/priority

Action: Create remediation tasks or dismiss false positives

Managing Gap Analyses

Navigate to GR → AI → Gap Analysis

View analyses by requirement or date

For each gap:

Verify accuracy against actual compliance status
Adjust priority if needed
Create remediation action or dismiss

Creating Remediation from Gaps

Open a gap analysis result

Click Create Remediation on any gap item

The system pre-fills:

Description from gap analysis
Suggested actions as tasks
Priority based on gap priority

Assign owner and due date

Save to create remediation record

Audit Preparation Management

Managing AI Audit Prep

Navigate to GR → AI → Audit Prep

View preparation assessments by audit

For each assessment:

Review readiness score and narrative
Validate checklist items
Assign checklist items to staff
Track completion

Readiness Score Interpretation

Score	Status	Action Needed
90-100%	Excellent	Minor polish, ready for audit
70-89%	Good	Address priority items
50-69%	Fair	Significant work needed
Below 50%	Poor	Major remediation required

Exporting Audit Prep

Click Export to generate a PDF or Excel checklist
Use for team distribution and tracking
Include in audit preparation documentation

AI Risk Assessment Management

Managing AI Risk Assessments

Navigate to GR → AI → Risk Assessment

View assessments by risk

For each assessment:

Compare AI scores with current risk scores
Validate or adjust likelihood/impact
Review suggested mitigation strategy
Create mitigation actions if appropriate

Applying AI Recommendations

When accepting an AI risk assessment:

Open the assessment details

Click Apply to Risk

Select which values to update:

Likelihood score
Impact score
Mitigation strategy

Add any manual adjustments

Save to update the risk record

AI Prompt Templates

The AI uses specialized prompts for different functions. Understanding these helps interpret outputs.

Compliance Chat

General compliance guidance
Regulatory interpretation
Documentation requirements
Best practices

Requirement Identification

Identifies applicable requirements based on:

Organization type
Accreditations held
State of operation
Services provided

Gap Analysis

Analyzes gaps considering:

Evidence gaps (missing documentation)
Check gaps (missing verifications)
Training gaps (staff training needs)
Policy gaps (missing/outdated policies)

Audit Preparation

Assesses readiness based on:

Audit type (CARF, State, CMS)
Historical findings
Current compliance status
Documentation completeness

Risk Assessment

Evaluates risks using:

Likelihood (1-5 scale)
Impact (1-5 scale)
Risk matrix calculation
Mitigation strategy recommendations

AI Model Information

The AI Compliance Advisor uses Lovable AI, which provides access to advanced language models.

Models Used

Default: Google Gemini 2.5 Flash (balanced speed/quality)
Complex analysis may use higher-capability models

Model Capabilities

Regulatory knowledge (CARF, Joint Commission, CMS, HIPAA, SAMHSA)
State licensing requirements
Compliance best practices
Gap identification
Risk assessment methodology

Model Limitations

Knowledge may not include latest regulatory updates
Cannot access external databases or real-time data
Provides guidance, not legal advice
May not know state-specific variations for all states

Best Practices

Getting Accurate AI Results

Provide Context: When using AI chat, include relevant details:

Organization type (recovery housing, behavioral health)
Accreditations (CARF, Joint Commission)
State of operation
Specific services offered

Be Specific: Ask targeted questions rather than broad ones:

✅ “What are CARF documentation requirements for medication management?”
❌ “Tell me about CARF”

Verify Outputs: Always validate AI suggestions against:

Current regulatory standards
State-specific requirements
Your organization’s specific context

Use Confidence Scores: Pay attention to confidence levels:

High confidence (80%+): Likely accurate
Lower confidence: Requires more validation

Reviewing AI Suggestions Efficiently

Prioritize by Type: Review in this order:

Critical priority items first
Requirement suggestions (new compliance needs)
Gap suggestions (current deficiencies)
Remediation suggestions (action items)

Batch Similar Items: Group related suggestions for efficient review

Document Rejections: When rejecting, provide clear reasons to:

Inform future AI improvements
Maintain audit trail
Help other reviewers understand decisions

Data Privacy

What Data is Sent to AI

Anonymized organizational context
Regulatory framework references
Compliance questions and queries
Never: PHI, PII, or identifying information

Data Protection

All AI interactions are logged for audit purposes
No patient/resident identifiable information is included
AI suggestions are stored in your organization’s database
Data remains within your organization’s tenant

PHI Protection

The system automatically:

Uses anonymized references (e.g., “Resident R-001”)
Strips identifying information from prompts
Blocks queries that appear to contain PHI

Rate Limits & Usage

Understanding Rate Limits

AI features have usage limits to ensure fair access:

Error	Meaning	Resolution
429 Too Many Requests	Rate limit exceeded	Wait a moment and retry
402 Payment Required	Credits depleted	Contact administrator

Managing Usage

Monitor usage through the AI dashboard
Prioritize AI use for high-value activities
Use batch operations when possible
Cache results rather than regenerating

Troubleshooting

Common Issues

Issue	Cause	Solution
AI features not visible	Not enabled	Enable in GR Settings → AI
”Rate limited” error	Too many requests	Wait and retry
”Credits depleted” error	Usage limit reached	Contact workspace admin
Inaccurate suggestions	Missing context	Provide more organization context
Slow responses	High demand	Wait for completion, don’t retry

AI Not Working

Verify AI is enabled: GR → Settings → AI

Check for error messages in the UI

Try a simple test query in AI Chat

Check network connectivity

Contact system administrator if issues persist

Reporting AI Issues

To report problems with AI outputs:

Note the specific suggestion/analysis ID

Document what was incorrect

Provide the expected correct answer if known

Submit feedback through the suggestion interface

Module Settings Reference

AI Settings Tab

Setting	Description	Default
Enable AI Compliance Advisor	Master toggle for all AI features	ON

Other GR settings that affect AI behavior:

Organization type and accreditations (contextual)
State of operation (regulatory context)
Services offered (requirement filtering)

Security Considerations

Access Control

All org members can view AI suggestions
All org members can generate AI content
Only compliance officers can accept/reject suggestions
Only compliance officers can delete AI data

Audit Trail

All AI interactions are logged including:

User who triggered generation
Timestamp
Input context
Generated output
Accept/reject decisions with reasons

Data Retention

AI-generated data follows your organization’s data retention policies. To remove AI data:

Navigate to the AI dashboard

Select items to delete

Confirm deletion (compliance officer only)

​Overview

​Enabling AI Features

​Prerequisites

​Default State

​Re-enable AI for Your Organization

​Disable AI Features

​Managing AI Suggestions

​Review Workflow

​Bulk Actions

​Suggestion Lifecycle

​Reviewing AI Gap Analyses

​Gap Analysis Workflow

​Managing Gap Analyses

​Creating Remediation from Gaps

​Audit Preparation Management

​Managing AI Audit Prep

​Readiness Score Interpretation

​Exporting Audit Prep

​AI Risk Assessment Management

​Managing AI Risk Assessments

​Applying AI Recommendations

​AI Prompt Templates

​Compliance Chat

​Requirement Identification

​Gap Analysis

​Audit Preparation

​Risk Assessment

​AI Model Information

​Models Used

​Model Capabilities

​Model Limitations

​Best Practices

​Getting Accurate AI Results

​Reviewing AI Suggestions Efficiently

​Data Privacy

​What Data is Sent to AI

​Data Protection

​PHI Protection

​Rate Limits & Usage

​Understanding Rate Limits

​Managing Usage

​Troubleshooting

​Common Issues

​AI Not Working

​Reporting AI Issues

​Module Settings Reference

​AI Settings Tab

​Related Settings

​Security Considerations

​Access Control

​Audit Trail

​Data Retention

​Related Documentation