Linear Integration

What it does

The Linear integration works similarly to the Jira integration: it pulls Linear issues into Specky as signals and lets you push PRD requirements to Linear as issues via the Execution Bridge. If your engineering team uses Linear instead of Jira, this is your primary execution integration.

When to use it

To see Linear issues alongside customer feedback in the Discovery Hub

To push PRD requirements to Linear as pre-filled issues with one click

To keep Linear issues updated when PRD requirements change

To link Linear projects to Specky roadmap initiatives

Setup

Go to Settings → Integrations → Linear

Click Connect Linear

Authorize via Linear OAuth

Select which Linear teams and projects to sync

Configure label mappings (optional — map Linear labels to Specky signal types)

Click Start Sync

What gets synced (Linear → Specky)

Issues: title, description, status, priority, assignee, labels, cycle

Sub-issues and parent relationships

Comments on issues

Project updates

Pushing to Linear (Specky → Linear)

Use the Execution Bridge in the PRD Editor:

Open a PRD and click Execution Bridge

Select Linear as the target

Choose the target team and project

Review the generated issue previews

Set assignees, labels, and priority

Click Create Issues

Each created Linear issue includes a link back to the Specky PRD, and the PRD shows a list of all linked Linear issues in its Activity panel.

Keeping issues in sync

When a PRD requirement changes, open the Execution Bridge and click Sync Changes to update the linked Linear issue. You'll see a diff of what will change before confirming.

Tips

Use Linear's cycle feature alongside Specky's roadmap for sprint-level planning

Map Linear's priority levels (Urgent/High/Medium/Low) to Specky's P0/P1/P2 in the label mapping settings

If you use both Jira and Linear, you can connect both — Specky will show issues from both in the Discovery Hub