← Back to patterns
build

How Cursor and Linear Solved the Fragmented Context Problem

TRIGGER

Coding agents working from issue trackers lack codebase context, while agents working from IDEs lack product and project context—forcing users to manually bridge the gap by copying requirements into prompts or explaining business logic that already exists elsewhere.

APPROACH

Cursor built a Linear integration that connects two context sources: Linear provides product, customer, and project context (issue descriptions, comments, project structure), while Cursor provides codebase context, development history, and engineering practices. Input: Linear issue assignment to Cursor agent. Output: agent receives combined context from both systems, executes coding task, opens PR, and updates progress back in Linear. The agent exposes 'thoughts' and 'tools' state through Linear's API so users can monitor progress without leaving their workflow.

PATTERN

The same agent produces inconsistent quality when context is fragmented—good results on rich issues, failures on bare-bones tickets. Assembling context from both the "why" system (issue tracker) and "how" system (codebase) unlocks improvements no prompt engineering can match.

WORKS WHEN

  • Teams already use separate systems for project management and code development
  • Issues contain meaningful product context beyond just a title (customer feedback, acceptance criteria, linked discussions)
  • Codebase has enough history and patterns for the agent to learn engineering practices from
  • Tasks are well-scoped enough that combined context provides sufficient grounding (P2/P3 backlog items, small-to-medium changes)

FAILS WHEN

  • Issues are just titles without context ('fix the bug', 'update styles')
  • Codebase is new or lacks established patterns for agent to learn from
  • Tasks require context that lives outside both systems (verbal agreements, Slack discussions, tribal knowledge)
  • Work spans multiple repositories or projects where context becomes fragmented

Stage

build

From

August 2025

Want patterns like this in your inbox?

3 patterns weekly. No fluff.