Skip to main content

Linear

Linear is used for delivery task handoff.

Connect Linear when you are ready to generate tasks from approved documents and completed discovery. Relay uses user-actor OAuth with these scopes:

  • read
  • write
  • admin

Admin scope is needed for webhook setup. Relay stores tokens encrypted, refreshes access tokens, and marks the connection action-required if refresh or webhook setup fails.

When task generation runs, Relay:

  • Creates or reuses a Linear project for the initiative.
  • Creates or reuses issues for generated Relay tasks.
  • Adds deterministic Relay task IDs to issue titles and descriptions for reconciliation.
  • Maps task complexity to Linear estimates.
  • Creates blocking relationships from task dependencies.
  • Updates Relay task state from Linear issue webhooks.

Linear remains the team's work tracker. Relay does not require custom Linear workflow statuses. In blueprint workflows, Relay uses Relay Blueprint / ... labels and a Relay-managed issue description block.