---
name: tracker/linear-official:issue-transition
description: Transition Linear issue to a new workflow state
version: "0.5.0"
---

> **Backend:** linear-official (linear@claude-plugins-official)
> **Note:** Requires `linear@claude-plugins-official` plugin. Install: `/plugin install linear@claude-plugins-official`
> **Tool names are provisional.** Exact MCP tool names will be confirmed when the Linear plugin is available. Update this file after enabling the plugin and running tool discovery.

# Linear Issue Transition

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| issue_id | string | Yes | Internal Linear UUID for the issue |
| state_name | string | Yes | Target workflow state name (e.g., "In Progress", "Done", "Cancelled") |

## Implementation

Uses `mcp__linear__updateIssueState` (TBD). Resolves the workflow state by matching state_name against the states defined for the issue's team, then updates the issue state. State names are case-sensitive and must match a state configured in the team's workflow.

## Output

| Field | Type | Description |
|-------|------|-------------|
| success | boolean | Whether the transition succeeded |
| previous_state | string | Name of the state before the transition |
| new_state | string | Name of the state after the transition |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| ISSUE_NOT_FOUND | No issue matches the provided issue_id | Use linear-official:issue-search to locate the issue |
| STATE_NOT_FOUND | No workflow state matches state_name in the issue's team | Check state names in the team's workflow settings |
| AUTH_FAILED | Plugin is missing, not installed, or lacks write permission | Run `/plugin install linear@claude-plugins-official` and verify plugin auth |

## Used By

- deploy-tracker
- dev-task
