Linear Integration

Integrate BugBrain with Linear to automatically create and manage test failure issues in your project management system.

Features

• Auto-create Linear issues from test failures
• Smart routing — Assign to team/project based on test area
• Priority mapping — Map BugBrain severity to Linear priority
• Status sync — Update Linear status when test is fixed
• Cycle planning — Add issues to current cycle automatically
• Growth+ plan required

Setup

1. Connect Linear Account

   • Settings → Integrations → Linear
   • Authorize BugBrain app
   • Grant access to create/update issues

2. Select Projects

   • Choose Linear projects to receive issues
   • Configure default team for auto-created issues

3. Configure Severity Mapping

   • Critical bugs → Urgent priority
   • High bugs → High priority
   • Medium bugs → Medium priority

Issue Creation

Created Linear Issues include:

• Test name and failure description
• AI-generated fix suggestions
• Link to execution report with screenshots
• Custom fields (test_plan, execution_id)

Team & Project Routing

Route issues based on failure area:

Authentication test failures → @auth-team
Payment test failures → @payments-team
Search test failures → @search-team

Configure in Settings → Integrations → Linear → Routing Rules

Priority Mapping

Cycle Management

Auto-add to Linear cycles:

• Current cycle — Automatically add new issues
• Backlog only — Manual cycle assignment
• Disabled — No cycle assignment

Option set in Integrations configuration.

Deduplication

• Time window: 24 hours
• Match criteria: Same test name + same failure type
• Action: Updates existing issue, comments with new occurrence

Troubleshooting

• Issues not creating — Check Linear project permissions
• Wrong team assignment — Verify routing rules in settings
• Priority incorrect — Confirm severity threshold matches expectations