linear-reference-architecture

Production-grade Linear integration architecture patterns. Use when designing system architecture, choosing integration patterns, or reviewing architectural decisions for Linear integrations. Trigger: "linear architecture", "linear system design", "linear integration patterns", "linear best practices architecture".

跳到安装

仓库: jeremylongshore/claude-code-plugins-plus-skills
最近来源活动: 2026年7月17日 22:18
检测到的 SKILL.md 语言: 英语
星标: 2,604
分支: 378

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill linear-reference-architecture

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

2 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

查看这个仓库的全部 Skills

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.

// 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 } }, : { : { : [, ] } }, }, : , }); } () { labels = client.({ : { : { : } } }); client.({ teamId, title, description, : , : labels.. ? [labels.[].] : [], }); }

name	linear-reference-architecture
description	Production-grade Linear integration architecture patterns. Use when designing system architecture, choosing integration patterns, or reviewing architectural decisions for Linear integrations. Trigger: "linear architecture", "linear system design", "linear integration patterns", "linear best practices architecture".
allowed-tools	Read, Write, Edit, Grep
version	1.12.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","linear","linear-reference"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

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.

// 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 } },
      : { : { : [, ] } },
    },
    : ,
  });
}

   () {
   labels =  client.({ : { : { :  } } });
   client.({
    teamId,
    title,
    description,
    : ,
    : labels.. ? [labels.[].] : [],
  });
}

// src/linear-gateway.ts import { LinearClient } from "@linear/sdk"; class LinearGateway { private client: LinearClient; private cache = new Map<string, { data: any; expiresAt: number }>(); private requestQueue: Array<{ fn: () => Promise<any>; resolve: Function; reject: Function }> = []; private processing = false; constructor(apiKey: string) { this.client = new LinearClient({ apiKey }); } // Cached reads async getTeams() { return this.cachedQuery("teams", () => this.client.teams().then(r => r.nodes), 600); } async getStates(teamId: string) { return this.cachedQuery(`states:${teamId}`, async () => { const team = await this.client.team(teamId); return (await team.states()).nodes; }, 1800); } // Rate-limited writes async createIssue(input: any) { return this.enqueue(() => this.client.createIssue(input)); } async updateIssue(id: string, input: any) { return this.enqueue(() => this.client.updateIssue(id, input)); } // Custom queries through the gateway async rawQuery(query: string, variables?: any) { return this.enqueue(() => this.client.client.rawRequest(query, variables)); } // Cache invalidation (called from webhook handler) invalidate(pattern: string) { for (const key of this.cache.keys()) { if (key.startsWith(pattern)) this.cache.delete(key); } } private async cachedQuery<T>(key: string, fn: () => Promise<T>, ttlSec: number): Promise<T> { const cached = this.cache.get(key); if (cached && Date.now() < cached.expiresAt) return cached.data; const data = await this.enqueue(fn); this.cache.set(key, { data, expiresAt: Date.now() + ttlSec * 1000 }); return data; } private async enqueue<T>(fn: () => Promise<T>): Promise<T> { return new Promise((resolve, reject) => { this.requestQueue.push({ fn, resolve, reject }); if (!this.processing) this.processQueue(); }); } private async processQueue() { this.processing = true; while (this.requestQueue.length > 0) { const { fn, resolve, reject } = this.requestQueue.shift()!; try { resolve(await fn()); } catch (e) { reject(e); } if (this.requestQueue.length > 0) { await new Promise(r => setTimeout(r, 100)); // 10 req/sec max } } this.processing = false; } } export const gateway = new LinearGateway(process.env.LINEAR_API_KEY!);

Error	Cause	Solution
Rate limit exceeded	Too many direct API calls	Route all calls through gateway
Stale cache	TTL too long, missed webhook	Webhook invalidation + periodic full sync
Event loss	Webhook delivery failure	Idempotent handlers + consistency checks
Schema drift	SDK version mismatch	Pin version, test upgrades in staging

linear-reference-architecture

安装方式

检查来源文件

Linear Reference Architecture

Overview

Architecture Decision Matrix

Architecture 1: Simple Integration

Linear Reference Architecture

Overview

Architecture Decision Matrix

Architecture 1: Simple Integration

Architecture 2: Service-Oriented with Gateway

Architecture 3: Event-Driven

Architecture 4: CQRS with Local State

Project Structure

Error Handling

Resources

linear-reference-architecture

来源信息

安装方式

检查来源文件

同仓库更多 Skills

同仓库更多 Skills

Linear Reference Architecture

Overview

Architecture Decision Matrix

Architecture 1: Simple Integration

Linear Reference Architecture

Overview

Architecture Decision Matrix

Architecture 1: Simple Integration

Architecture 2: Service-Oriented with Gateway

Architecture 3: Event-Driven

Architecture 4: CQRS with Local State

Project Structure

Error Handling

Resources