Skip to main content

Linear

Linear is used for explicit Delivery Plan issue handoff.

Connect Linear when you are ready to send reviewed inrelay draft tasks into Linear issues. inrelay uses user-actor OAuth with these scopes:

  • read
  • write
  • admin

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

Delivery Plan generation creates editable inrelay draft tasks and does not create Linear issues. When Send to Linear runs, inrelay:

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

Linear remains the team's work tracker after handoff. inrelay freezes the task contract fields it sent to Linear and allows only local non-authoritative metadata in inrelay for pack preparation. inrelay does not require custom Linear workflow statuses. In blueprint workflows, inrelay uses inrelay Blueprint / ... labels and an inrelay-managed issue description block.