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

# Forms & Workflow Overview

> Overview of the Forms & Workflow core in Encore OS — purpose, scope, and key responsibilities.

The Forms & Workflow core (FW) provides cross-cutting form management and business process automation for Encore OS — form builders, workflow definitions, durable execution, event-driven automation, workflow versioning, and form analytics.

<Note>
  **Architecture:** FW is a cross-cutting capability used by multiple cores through the Platform Integration Layer. Other cores consume FW via integration contracts and events — never direct imports.
</Note>

## How automation flows

Authors build forms and compose them into versioned workflow definitions. Triggers — cross-core events, scheduled cron, or webhooks — start a durable, resumable execution whose step history and completion feed analytics.

```mermaid theme={null}
flowchart LR
  Form["Form builder<br/>(schema + logic)"] --> Workflow["Workflow definition<br/>(branching · retries ·<br/>human-in-the-loop)"]
  Workflow --> Version["Versioning"]
  Trigger["Triggers<br/>(events · cron · webhooks)"] --> Exec["Durable execution"]
  Version --> Exec
  Exec --> Analytics["Analytics<br/>(completion · drop-off ·<br/>time-to-complete)"]
  Cores["Other cores<br/>(via events)"] -.-> Trigger
```

<Frame caption="Scheduled workflows — recurring automation across the platform.">
  <img src="https://mintcdn.com/encoreos/9uGfYOeeHogjmoRk/images/fw-schedules/schedules-overview.png?fit=max&auto=format&n=9uGfYOeeHogjmoRk&q=85&s=62ca06a9991c412cbf350d00526edf52" alt="Forms and Workflow scheduled jobs overview" width="1440" height="900" data-path="images/fw-schedules/schedules-overview.png" />
</Frame>

## What FW covers

<CardGroup cols={2}>
  <Card title="Form builder" icon="pen-ruler">
    Schema definitions, conditional logic, validation, and multi-step forms.
  </Card>

  <Card title="Workflow builder" icon="diagram-project">
    Durable processes with branching, retries, and human-in-the-loop steps.
  </Card>

  <Card title="Durable execution" icon="gears">
    Long-running, resumable executions with full step history.
  </Card>

  <Card title="Event automation" icon="bolt" href="/architecture/integrations/CL-FW-EVENT-AUTOMATION-INTEGRATION">
    Triggers from cross-core events, scheduled cron, and webhooks.
  </Card>

  <Card title="Versioning" icon="code-branch">
    Schema versioning and migration of in-flight instances.
  </Card>

  <Card title="Analytics" icon="chart-line">
    Completion rates, drop-off, and time-to-complete metrics.
  </Card>
</CardGroup>

## Get oriented in FW

<Steps>
  <Step title="Build a form">
    Define a schema with conditional logic and validation in the form builder.
  </Step>

  <Step title="Define the workflow">
    Compose durable steps with branching, retries, and approvals.
  </Step>

  <Step title="Automate on events">
    Wire [cross-core triggers](/architecture/integrations/event-based-workflow-triggers-integration) so workflows run when other cores publish events.
  </Step>
</Steps>

## By role

<Tabs>
  <Tab title="Workflow administrator">
    Design and deploy workflows; manage versions and migrations.
  </Tab>

  <Tab title="Form author">
    Build intake, assessment, and audit forms.
  </Tab>

  <Tab title="Operations engineer">
    Monitor durable executions and debug failed steps.
  </Tab>

  <Tab title="Compliance">
    Audit completed forms and workflow evidence.
  </Tab>
</Tabs>

## Scope at a glance

* **Form builders** — schema definitions, conditional logic, validation rules, multi-step forms.
* **Workflow definitions** — durable processes, branching, retries, human-in-the-loop steps.
* **Event-driven automation** — triggers from cross-core events, scheduled cron, webhook entry.
* **Versioning** — form and workflow schema versioning, migration of in-flight instances.
* **Analytics** — completion rates, drop-off, time-to-complete metrics.

## Related

<CardGroup cols={2}>
  <Card title="Cross-core triggers" icon="bolt" href="/architecture/integrations/event-based-workflow-triggers-integration">
    How FW listens to events from other cores.
  </Card>

  <Card title="HR integration" icon="users" href="/architecture/integrations/HR-FW-INTEGRATION">
    Workforce forms and workflow automation.
  </Card>

  <Card title="CL event automation" icon="stethoscope" href="/architecture/integrations/CL-FW-EVENT-AUTOMATION-INTEGRATION">
    Clinical event hand-off into workflows.
  </Card>

  <Card title="PM business rules" icon="calendar-check" href="/architecture/integrations/pm-triggered-business-rule-automation-integration">
    Practice-management-triggered automation.
  </Card>
</CardGroup>
