linear-core-workflow-a

name	linear-core-workflow-a
description	Issue lifecycle management with Linear: create, update, transition, relate, comment, and organize issues through the SDK and GraphQL API. Trigger: "linear issue workflow", "linear issue lifecycle", "create linear issues", "update linear issue", "linear state transition", "linear sub-issues", "linear comments".
allowed-tools	Read, Write, Edit, Grep
version	1.12.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","linear","workflow"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Linear Core Workflow A: Issue Lifecycle

Overview

Master issue lifecycle management: creating, updating, transitioning states, building parent/sub-issue hierarchies, managing labels, and commenting. Linear issues flow through typed workflow states (triage -> backlog -> unstarted -> started -> completed | canceled), belong to a team, and support priorities 0-4, estimates, due dates, labels, and cycle/project assignment.

Prerequisites

• @linear/sdk installed with API key or OAuth token configured
• Access to target team(s)
• Understanding of your team's workflow states

Instructions

Step 1: Create Issues

import { LinearClient } from "@linear/sdk";

const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY! });

// Get team
const teams = await client.teams();
const team = teams.nodes.find(t => t.key === "ENG") ?? teams.nodes[0];

// Basic issue
const result = await client.createIssue({
  teamId: team.id,
  title: "Implement user authentication",
  description: "Add OAuth 2.0 login flow with Google and GitHub providers.",
  priority: 2, 
});

 (result.) {
   issue =  result.;
  .();
  .();
}


 labelResult =  client.({ : { : { :  } } });
 bugLabel = labelResult.[];
 states =  team.();
 todoState = states..( s. === )!;

 client.({
  : team.,
  : ,
  : ,
  : ,
  : todoState.,
  : ,
  : bugLabel ? [bugLabel.] : [],
  : ,
  : ,
});