> ## 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.

# Workflow Optimization

> Review AI-powered optimization suggestions and compliance scores for workflow performance and reliability.

The Workflow Optimization page at `/fw/optimization` surfaces AI-powered suggestions for improving workflow performance, reliability, and compliance. It also shows a compliance score derived from best-practice checks.

## Overview

The page is gated by `fw.optimization.view` via `PermissionGate`. It fetches optimization suggestions via `useOptimizationSuggestions` and compliance scores via `useComplianceScores`, both scoped to the active organization. Suggestions are tabbed into Pending and Resolved. Each suggestion card shows severity (critical, warning, info, optimization), suggestion type, title, and description, with Apply and Dismiss actions for pending suggestions gated by `fw.optimization.manage`.

## Who it's for

Requires `fw.optimization.view` permission (enforced by `PermissionGate` wrapping the page content). Users without this permission see a "You do not have permission" message instead of the page content.

Apply and Dismiss actions require `fw.optimization.manage` (gated by an inner `PermissionGate`).

## Before you start

* You must have `fw.optimization.view` to see optimization data.
* You must have `fw.optimization.manage` to apply or dismiss suggestions.
* An organization must be active for suggestions to be scoped correctly.

## Steps

**Viewing suggestions:**

1. Navigate to `/fw/optimization`.
2. Review the **Compliance Score** card showing the latest overall score and best-practice pass/fail counts.
3. Review the **Pending** tab for actionable suggestions.
4. Switch to the **Resolved** tab for previously applied or dismissed suggestions.

**Applying a suggestion (requires `fw.optimization.manage`):**

1. On a pending suggestion card, select **Apply**.
2. On success, a toast confirms "Suggestion applied" and the suggestion moves to the Resolved tab.

**Dismissing a suggestion (requires `fw.optimization.manage`):**

1. On a pending suggestion card, select **Dismiss**.
2. On success, a toast confirms "Suggestion dismissed" and the suggestion moves to the Resolved tab.

## Key concepts

* **Severity levels** — `critical`, `warning`, `info`, `optimization`. Each has a distinct icon and color coding.
* **Suggestion type** — Classifies the nature of the suggestion (e.g., performance, reliability, compliance). Displayed as a secondary badge.
* **Compliance score** — An overall percentage score derived from best-practice checks. Color-coded: green ≥ 80%, yellow ≥ 60%, red below 60%.
* **Apply vs. Dismiss** — Apply acts on the suggestion (SME: confirm auto-apply scope); Dismiss marks it as resolved without action.

## Related

<Columns cols={2}>
  <Card title="Forms & Workflow" icon="diagram-project" href="/fw/overview">
    Forms & Workflow core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fw\.tsx
  * src/cores/fw/pages/WorkflowOptimizationPage.tsx
  * src/cores/fw/hooks/useOptimizationSuggestions.ts
  * src/cores/fw/hooks/useComplianceScore.ts
  * src/cores/fw/hooks/useApplySuggestion.ts
  * src/cores/fw/types/optimization-suggestions.ts
</Accordion>