ENGINEERING

Remind authors to link PRs to a Linear issue

When a PR opens without a linked Linear issue in its title or branch, it comments asking the author to attach one, and stays quiet once a valid issue reference is present.

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerwebhook
Steps4
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPR opened or editedGitHubGitHub
  • LogicLinear issue key present?
  • ActionVerify issue exists in LinearLinearLinear
  • OutputComment asking to link an issueGitHubGitHub

What it does

This workflow checks new pull requests for a Linear issue reference (like ENG-123) in the branch name, title, or description. If none is found, it confirms against the Linear API that no matching issue exists, then comments on the PR asking the author to link the relevant issue so work stays traceable. PRs that already reference a valid issue are left untouched.

When to use it

When your team tracks work in Linear and wants every code change tied back to an issue for traceability and release planning, but reviewers keep forgetting to enforce it manually.

How it works

  1. 1A GitHub webhook fires when a PR is opened or edited.
  2. 2The workflow scans the branch, title, and body for a Linear issue key pattern.
  3. 3If a key is found, it verifies the issue exists in Linear and ends quietly.
  4. 4If no key is found, a logic branch routes to the nudge path.
  5. 5It posts a PR comment asking the author to link a Linear issue, with a short note on why traceability matters.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect LinearIssues, projects, cycles, triage.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.