linear-reference-architecture

# Linear Reference Architecture ## Overview Production-grade architectural patterns for Linear integrations. Choose the right pattern based on team size, complexity, and real-time requirements. ## Architecture Decision Matrix | Pattern | Best For | Complexity | Rate Budget | Example | |---------|----------|------------|-------------|---------| | Simple | Single app, small team | Low | < 500 req/hr | Internal dashboard | | Service-Oriented | Multiple apps, shared state | Medium | 500-2,000 req/hr | Platform with Linear sync | | Event-Driven | Real-time needs, many consumers | High | < 500 req/hr + webhooks | Multi-service notification system | | CQRS | Audit trails, complex queries | Very High | Minimal API calls | Compliance-grade tracking | ## Architecture 1: Simple Integration Direct SDK calls from your application. Best for scripts, internal tools, and prototypes. ```typescript // src/linear.ts — single module, shared client import { LinearClient } from "@linear/sdk"; const client = new LinearClient({ apiKey: process.env.LINEAR_API_KEY! }); // Direct SDK calls from any part of your app export async function getOpenIssues(teamKey: string) { return client.issues({ first: 50, filter: { team: { key: { eq: teamKey } }, state: { type: { nin: ["completed", "canceled"] } }, }, orderBy: "priority", }); } export async function createBugReport(teamId: string, title: string, description: string) { const labels = await client.issueLabels({ filt...