<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/adr/2.x/2026-02-11-5-task-tracker-agnostic-connector-architecture/">
  <id>https://docs.spec-kitty.ai/adr/2.x/2026-02-11-5-task-tracker-agnostic-connector-architecture/</id>
  <title>Task-Tracker-Agnostic Connector Architecture</title>
  <updated>2026-02-11T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/adr/2.x/2026-02-11-5-task-tracker-agnostic-connector-architecture/"/>
  <summary>Treats Jira as one connector behind a shared interface rather than an architectural assumption, keeping Linear, Asana, and GitHub Issues equally first-class.</summary>
  <content type="html">&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;During Feature 014 (Acquisition Strategy &amp;#x26; Competitive Analysis), &lt;strong&gt;Jira&lt;/strong&gt; appeared frequently in competitive positioning documents as the “Ideal Task Tracker Profile” for ICP (Ideal Customer Profile) analysis. This led to potential confusion about Jira’s architectural role in Spec Kitty:&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Business/Positioning Context&lt;/strong&gt; (Feature 014):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Jira is widely used in Atlassian ecosystem (250K+ customers)&lt;/li&gt;
&lt;li&gt;Atlassian is primary acquisition target ($10-30M estimated acquisition price for Spec Kitty)&lt;/li&gt;
&lt;li&gt;Many enterprise customers use Jira for project management&lt;/li&gt;
&lt;li&gt;Jira integration is valuable for enterprise sales positioning&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Architectural Risk&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Confusion: Is Jira architecturally special? Should core models (Event, WorkPackage) have Jira-specific fields?&lt;/li&gt;
&lt;li&gt;Vendor lock-in: If Jira assumptions hardcoded in event log, state machine, or sync protocol, we lose flexibility&lt;/li&gt;
&lt;li&gt;Market risk: Task tracker landscape is diverse (Linear, Asana, Monday, ClickUp, GitHub Issues) - cannot assume Jira dominance&lt;/li&gt;
&lt;li&gt;Future-proofing: New task trackers will emerge; architecture must be agnostic&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Key Question&lt;/strong&gt;: Is Jira (and task trackers generally) CORE architecture or EXTERNAL integration?&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Current State&lt;/strong&gt;: No architectural decisions documented on task tracker integration philosophy.&lt;/p&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Vendor independence&lt;/strong&gt;: Spec Kitty must not be architecturally tied to any single task tracker&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market flexibility&lt;/strong&gt;: Different customers use different tools (Jira, Linear, Asana, Monday, ClickUp, GitHub Issues)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Future-proofing&lt;/strong&gt;: Task tracker market evolves; new tools emerge (e.g., Linear launched 2019, now major player)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition positioning&lt;/strong&gt;: Ironically, being Jira-agnostic is MORE valuable to Atlassian (demonstrates platform, not point solution)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clear separation&lt;/strong&gt;: Business/ICP decisions (Jira is ideal customer profile) vs Architecture (Jira is one connector among equals)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Integration patterns&lt;/strong&gt;: Follow industry best practice (abstraction layer for external services)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Option 1&lt;/strong&gt;: Task-tracker-agnostic connector architecture (chosen)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 2&lt;/strong&gt;: Jira-first architecture (Jira special treatment in core models)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 3&lt;/strong&gt;: No task tracker integration (miss enterprise value)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 4&lt;/strong&gt;: Manual integration only (limits automation)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen option:&lt;/strong&gt; “Task-tracker-agnostic connector architecture with unified &lt;code dir=&quot;auto&quot;&gt;TaskTrackerConnector&lt;/code&gt; interface”, because:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Vendor independence&lt;/strong&gt;: No architectural lock-in to Jira or any single tracker&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market flexibility&lt;/strong&gt;: Supports diverse customer tool preferences (Jira, Linear, Asana, Monday, ClickUp, GitHub Issues)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Future-proofing&lt;/strong&gt;: New task trackers easily added via connector interface&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition value&lt;/strong&gt;: Atlassian values platform architecture (broader than just Jira integration)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clear separation&lt;/strong&gt;: Jira is business/ICP focus (customer targeting), NOT architectural dependency&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Industry pattern&lt;/strong&gt;: Follows Zapier/n8n model (unified connector abstraction)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Implementation&lt;/strong&gt;: Create unified &lt;code dir=&quot;auto&quot;&gt;TaskTrackerConnector&lt;/code&gt; abstract base class in &lt;code dir=&quot;auto&quot;&gt;integrations/task_tracker.py&lt;/code&gt;. All task trackers (Jira, Linear, Asana, Monday, ClickUp, GitHub Issues) implement this interface with EQUAL priority. NO Jira-specific fields in core models (Event, WorkPackage, Project).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Jira’s Role - Clarified&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Business/ICP&lt;/strong&gt;: “Ideal Task Tracker Profile” for customer targeting, acquisition positioning (Feature 014)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Architecture&lt;/strong&gt;: One connector among many, equal priority with Linear, Asana, etc.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Why it appears often&lt;/strong&gt;: Many target customers use Atlassian ecosystem (business reason), NOT architectural special treatment&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;consequences&quot;&gt;Consequences&lt;/h3&gt;
&lt;h4 id=&quot;positive&quot;&gt;Positive&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Vendor independence&lt;/strong&gt;: No lock-in to Jira or any tracker (customer flexibility)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market coverage&lt;/strong&gt;: Serve customers with ANY task tracker (broader TAM)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Future-proof&lt;/strong&gt;: New trackers (e.g., next Linear/Notion) easily added via connector&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition value&lt;/strong&gt;: Atlassian sees platform (broader value) vs Jira point solution&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clean architecture&lt;/strong&gt;: Core models (Event, WorkPackage) have no task-tracker-specific fields&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Competitive advantage&lt;/strong&gt;: Differentiate from competitors locked to single tracker&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Abstraction cost&lt;/strong&gt;: Unified interface requires upfront design (more complex than single-tracker integration)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Lowest common denominator&lt;/strong&gt;: Interface may not expose tracker-specific features (Jira JQL, Linear cycles)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Testing complexity&lt;/strong&gt;: Must test against multiple trackers (Jira, Linear, Asana, etc.)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Documentation burden&lt;/strong&gt;: Need docs for each tracker integration (setup, auth, field mapping)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Jira still important&lt;/strong&gt;: Business/ICP focus on Jira is CORRECT (Atlassian customers are ideal), just not architecturally special&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Connector priority&lt;/strong&gt;: All trackers equal architecturally, but Jira may get marketing/sales priority (business decision)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Implementation order&lt;/strong&gt;: Can implement Jira connector first (business priority), then Linear, Asana (phased rollout)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Success Metrics&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Architectural cleanliness&lt;/strong&gt;: Zero Jira-specific fields in core models (Event, WorkPackage, Project)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Connector parity&lt;/strong&gt;: Jira, Linear, GitHub Issues connectors all implement same interface (no special cases)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market coverage&lt;/strong&gt;: 3+ task tracker integrations shipped (Jira, Linear, GitHub Issues)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Customer flexibility&lt;/strong&gt;: Customers can switch trackers without re-architecting Spec Kitty integration&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition value&lt;/strong&gt;: Atlassian recognizes platform value (demonstrated by multi-tracker support)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Validation Timeline&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Month 1&lt;/strong&gt;: Design &lt;code dir=&quot;auto&quot;&gt;TaskTrackerConnector&lt;/code&gt; interface (abstract methods, common data model)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Month 2&lt;/strong&gt;: Implement Jira connector (first implementation, validates interface)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Month 3&lt;/strong&gt;: Implement Linear connector (proves interface is tracker-agnostic)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Month 4&lt;/strong&gt;: Implement GitHub Issues connector (third tracker, confirms pattern)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Month 5-6&lt;/strong&gt;: Customer validation (users with different trackers successfully integrate)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Confidence Level&lt;/strong&gt;: &lt;strong&gt;HIGH&lt;/strong&gt; (9/10)&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Follows industry best practice (connector abstraction)&lt;/li&gt;
&lt;li&gt;Clear separation of business (Jira focus) vs architecture (tracker-agnostic)&lt;/li&gt;
&lt;li&gt;Proven pattern (Zapier, n8n use similar connector model)&lt;/li&gt;
&lt;li&gt;Low risk (abstraction adds complexity but prevents vendor lock-in)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;pros-and-cons-of-the-options&quot;&gt;Pros and Cons of the Options&lt;/h2&gt;
&lt;h3 id=&quot;task-tracker-agnostic-architecture-chosen&quot;&gt;Task-Tracker-Agnostic Architecture (Chosen)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Description&lt;/strong&gt;: Unified &lt;code dir=&quot;auto&quot;&gt;TaskTrackerConnector&lt;/code&gt; interface, all trackers equal priority architecturally.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Vendor independence&lt;/strong&gt;: No lock-in, customer flexibility&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market coverage&lt;/strong&gt;: Serve customers with ANY tracker&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Future-proof&lt;/strong&gt;: New trackers easily added&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition value&lt;/strong&gt;: Platform &gt; point solution (broader value to Atlassian)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clean architecture&lt;/strong&gt;: Core models have no tracker-specific fields&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Competitive advantage&lt;/strong&gt;: Differentiate from single-tracker competitors&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Abstraction cost&lt;/strong&gt;: Upfront design complexity&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Lowest common denominator&lt;/strong&gt;: May not expose tracker-specific features&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Testing complexity&lt;/strong&gt;: Must test multiple trackers&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Documentation burden&lt;/strong&gt;: Docs for each tracker&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;jira-first-architecture&quot;&gt;Jira-First Architecture&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Description&lt;/strong&gt;: Jira gets special treatment in core models (e.g., WorkPackage has jira_issue_id field).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Simpler initially&lt;/strong&gt;: Direct Jira integration, no abstraction&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Jira-specific features&lt;/strong&gt;: Can expose JQL, custom fields, Jira workflows&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Faster time-to-market&lt;/strong&gt;: Ship Jira integration sooner (no abstraction design)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Vendor lock-in&lt;/strong&gt;: Architecture tied to Jira (hard to support other trackers)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market limitation&lt;/strong&gt;: Customers with Linear, Asana, etc. cannot adopt Spec Kitty&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Future fragility&lt;/strong&gt;: If Jira declines or new tracker dominates, architecture is wrong&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Acquisition risk&lt;/strong&gt;: Atlassian may see point solution (lower value) vs platform&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Architectural debt&lt;/strong&gt;: Must refactor to support other trackers (costly migration)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;no-task-tracker-integration&quot;&gt;No Task Tracker Integration&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Description&lt;/strong&gt;: Spec Kitty has no task tracker integration (manual workflows only).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Simple&lt;/strong&gt;: No integration complexity&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Tracker-agnostic by default&lt;/strong&gt;: Users can use any tracker manually&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Misses enterprise value&lt;/strong&gt;: Task tracker integration is key enterprise requirement (bidirectional sync, automation)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Competitive gap&lt;/strong&gt;: Competitors with integrations win enterprise deals&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Manual workflows&lt;/strong&gt;: Users must manually copy data between Spec Kitty and tracker (friction)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;manual-integration-only&quot;&gt;Manual Integration Only&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Description&lt;/strong&gt;: Users manually export/import between Spec Kitty and trackers (no automated sync).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Simpler than automated sync&lt;/strong&gt;: No real-time sync complexity&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;User control&lt;/strong&gt;: Users decide when/what to sync&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Friction&lt;/strong&gt;: Manual export/import is tedious (low adoption)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Stale data&lt;/strong&gt;: Manual sync means data drifts out of sync&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Competitive gap&lt;/strong&gt;: Automated sync is expected feature (Zapier, n8n, etc.)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;more-information&quot;&gt;More Information&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;References&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Feature 014: &lt;code dir=&quot;auto&quot;&gt;research/014-acquisition-strategy-and-competitive-analysis/&lt;/code&gt; (Jira as ICP, Atlassian acquisition target)&lt;/li&gt;
&lt;li&gt;Product requirements: &lt;code dir=&quot;auto&quot;&gt;product-ideas/prd-agent-orchestration-integration-v1.md&lt;/code&gt; (AD-006, Section “Task Tracker Integration Philosophy”)&lt;/li&gt;
&lt;li&gt;Integration spec: &lt;code dir=&quot;auto&quot;&gt;competitive/tier-1-threats/entire-io/INTEGRATION-SPEC.md&lt;/code&gt; (Section “Layer 4: External Integrations”)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Implementation Files&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;integrations/task_tracker.py&lt;/code&gt; - TaskTrackerConnector abstract base class&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;integrations/jira_connector.py&lt;/code&gt; - JiraConnector implementation&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;integrations/linear_connector.py&lt;/code&gt; - LinearConnector implementation&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;integrations/github_issues_connector.py&lt;/code&gt; - GitHubIssuesConnector implementation&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;config/task_trackers.yaml&lt;/code&gt; - Configuration for all trackers&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Related ADRs&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;None (this is first ADR on task tracker integration philosophy)&lt;/li&gt;
&lt;li&gt;Future: Specific ADRs for each connector implementation (e.g., ADR for Jira OAuth flow, Linear GraphQL integration)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;TaskTrackerConnector Interface&lt;/strong&gt; (sketch):&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;from&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; abc &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;ABC&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, abstractmethod&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;from&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; typing &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; Dict, List&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#FFCB8B;--1:#111111&quot;&gt;TaskTrackerConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;ABC&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Abstract base class for task tracker integrations.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;@abstractmethod&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;async&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;fetch_issue&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;self&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;issue_id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; -&gt; Dict:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Fetch issue details from task tracker.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;pass&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;@abstractmethod&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;async&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;create_spec_from_issue&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;self&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;issue_id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; -&gt; Path:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Generate spec.md from task tracker issue.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;pass&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;@abstractmethod&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;async&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;sync_wp_status_to_issue&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;self&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;wp_id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;status&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Update issue status based on WP status.&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;pass&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;@abstractmethod&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;async&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;sync_issue_to_wp&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;self&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;issue_id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; -&gt; &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Create WP from issue (bidirectional sync).&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&quot;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;        &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;pass&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# All trackers implement this interface (equal priority)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#FFCB8B;--1:#111111&quot;&gt;JiraConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;TaskTrackerConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# ... Jira-specific implementation&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#FFCB8B;--1:#111111&quot;&gt;LinearConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;TaskTrackerConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# ... Linear-specific implementation&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#FFCB8B;--1:#111111&quot;&gt;GitHubIssuesConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;TaskTrackerConnector&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# ... GitHub-specific implementation&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Configuration Example&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;config/task_trackers.yaml&lt;/code&gt;):&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;yaml&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;task_trackers&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;jira&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;enabled&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;server_url&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;https://company.atlassian.net&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;credentials&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;env:JIRA_API_TOKEN&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;linear&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;enabled&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;api_key&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;env:LINEAR_API_KEY&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;github&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;enabled&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;token&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;env:GITHUB_TOKEN&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# All trackers equal priority in config&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;CLI Usage Examples&lt;/strong&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Generate spec from Jira issue&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specify&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--from-jira&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;PROJECT-123&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Generate spec from Linear issue&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specify&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--from-linear&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;ISSUE-456&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Generate spec from GitHub issue&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;specify&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--from-github&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;myorg/myrepo#789&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Sync WP status to any tracker&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;WP03&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--to-jira&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;PROJECT-123&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;WP03&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--to-linear&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;ISSUE-456&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;WP03&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--to-github&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;myorg/myrepo#789&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Jira’s Business Role vs Architectural Role&lt;/strong&gt;:&lt;/p&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Context&lt;/th&gt;&lt;th&gt;Jira’s Role&lt;/th&gt;&lt;th&gt;Rationale&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Business/ICP&lt;/strong&gt; (Feature 014)&lt;/td&gt;&lt;td&gt;&lt;strong&gt;“Ideal Task Tracker Profile”&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Many enterprises use Atlassian; Jira customers are ideal acquisition targets&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Marketing/Sales&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Primary messaging focus&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Lead with Jira integration (appeals to Atlassian ecosystem)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Architecture&lt;/strong&gt; (this ADR)&lt;/td&gt;&lt;td&gt;&lt;strong&gt;One connector among equals&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;No Jira-specific fields in core models; equal priority with Linear, Asana, etc.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Implementation Order&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Implement first&lt;/strong&gt; (Phase 3)&lt;/td&gt;&lt;td&gt;Business priority (most enterprise customers), NOT architectural priority&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Documentation&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Featured prominently&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Jira docs on homepage (appeals to target customer), but other trackers equally documented&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Acquisition Implications&lt;/strong&gt; (Atlassian):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Platform value&lt;/strong&gt;: Multi-tracker support demonstrates Spec Kitty is platform (broader appeal), not Jira point solution&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Integration showcase&lt;/strong&gt;: Jira connector demonstrates integration quality (Atlassian sees example of what they could build)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Non-threatening&lt;/strong&gt;: Being tracker-agnostic reduces perception of “only valuable for Jira” (broader strategic value to Atlassian)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Market validation&lt;/strong&gt;: If Spec Kitty succeeds with multiple trackers, validates TAM beyond just Jira users&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Rollback Plan&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;If abstraction is wrong: Can add tracker-specific fields to Event.payload (JSONB is flexible)&lt;/li&gt;
&lt;li&gt;If Jira features needed: JiraConnector can have Jira-specific methods (beyond interface minimum)&lt;/li&gt;
&lt;li&gt;Configuration: Can mark trackers as “primary” in config (business priority) while keeping architecture equal&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
