> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getlark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear integration

> Create Linear issues when a workflow uncovers a real product regression.

Lark can file a Linear issue when a deterministic workflow fails because of a bug in your product. Flaky scripts and infra hiccups do not file issues. Only failures classified as a real product regression do.

## Setup

1. Open **Settings → Integrations** in the [dashboard](https://dashboard.getlark.ai/settings/integrations).
2. Click **Connect** on the Linear card.
3. Authorize Lark in Linear. Lark requests `issues:create` and `comments:create` scopes.
4. Back in the dashboard, click **Configure**, pick the **default team** the issues should land in, and toggle **Issue creation** on.
5. Save.

## Triggers

Lark files a Linear issue in two cases:

| Trigger                    | When it fires                                                                                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Workflow execution failure | A deterministic workflow fails and Lark's [summarization](/workflow-lifecycle#summarization) classifies the failure as `app_issue` (a real product regression, not a broken script). |
| Repair failure             | A deterministic workflow's repair attempt fails, indicating Lark could not get the test passing again.                                                                               |

Issues land in the default team's backlog. The title is `Workflow Failed: <workflow name>` (or `Workflow Repair Failed: <workflow name>`), and the body includes the failure summary plus a link back to the dashboard.

## Reconfiguring or disconnecting

Click **Configure** on the Linear card to change the default team or pause issue creation without disconnecting.

Click **Disconnect** to revoke Lark's access. Lark stops creating issues; existing issues stay in Linear untouched.