[Extension]: Add spec-kit-linear

[ashbrener]

Extension ID

linear

Extension Name

spec-kit-linear

Version

0.2.0

Description

Mirror spec-kit feature directories into Linear (filesystem → Linear, reconcile-based, unidirectional).

Author

Ash Brener

Repository URL

https://github.com/ashbrener/spec-kit-linear

Download URL

https://github.com/ashbrener/spec-kit-linear/archive/refs/tags/v0.2.0.zip

License

MIT

Homepage (optional)

https://github.com/ashbrener/spec-kit-linear

Documentation URL (optional)

https://github.com/ashbrener/spec-kit-linear/blob/main/README.md

Changelog URL (optional)

https://github.com/ashbrener/spec-kit-linear/releases

Required Spec Kit Version

=0.1.0

Required Tools (optional)

• Linear MCP endpoint (https://mcp.linear.app/mcp) with OAuth (read, write, issues:create, comments:create) — verified at install time
• gh CLI — for the optional GitHub Action webhook layer
• git — local hooks

None are declarable in requires; all are checked by speckit.linear.install, which prints a structured dependency report.

Number of Commands

5

Number of Hooks (optional)

6

Tags

issue-tracking, linear, tasks-sync, lifecycle-mirror, memory, cross-repo

Key Features

• One Linear Issue per spec; sub-issues per task phase (checklists + inter-phase blocking relations)
• Automatic sync via six after_* lifecycle hooks (specify, clarify, plan, tasks, implement, analyze)
• Reconcile-based and idempotent — safe to re-run; push is the only path that mutates Linear
• Filesystem → Linear, unidirectional; pull / status are read-only
• Key-only install: team and project discovered interactively, no UUIDs surfaced to the operator
• Optional GitHub Action webhook layer for PR-driven workflow-state transitions

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on: macOS with the specify CLI, against a live Linear workspace.

Install: specify extension add linear --from https://github.com/ashbrener/spec-kit-linear/archive/refs/tags/v0.2.0.zip

Scenarios: install ceremony (MCP / OAuth / gh / git-hook verification) → seed (labels + workflow states) → push reconcile across multiple specs → sub-issue creation per task phase → drift/status report. Dogfooded during development: spec 002 mirrored to a live Linear workspace (parent Issue + 6 task-phase sub-issues).

Example Usage

# Install
specify extension add linear --from https://github.com/ashbrener/spec-kit-linear/archive/refs/tags/v0.2.0.zip

# One-time per repo: verify dependencies, then seed the workspace
/speckit.linear.install
/speckit.linear.seed

# Reconcile filesystem → Linear (also runs automatically after each /speckit-* command)
/speckit.linear.push

# Read-only views
/speckit.linear.status
/speckit.linear.pull

Proposed Catalog Entry

{
  "linear": {
    "name": "spec-kit-linear",
    "id": "linear",
    "description": "Mirror spec-kit feature directories into Linear (filesystem → Linear, reconcile-based, unidirectional).",
    "author": "Ash Brener",
    "version": "0.2.0",
    "download_url": "https://github.com/ashbrener/spec-kit-linear/archive/refs/tags/v0.2.0.zip",
    "repository": "https://github.com/ashbrener/spec-kit-linear",
    "homepage": "https://github.com/ashbrener/spec-kit-linear",
    "documentation": "https://github.com/ashbrener/spec-kit-linear/blob/main/README.md",
    "changelog": "https://github.com/ashbrener/spec-kit-linear/releases",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.1.0"
    },
    "provides": {
      "commands": 5,
      "hooks": 6
    },
    "tags": [
      "issue-tracking",
      "linear",
      "tasks-sync",
      "lifecycle-mirror",
      "memory",
      "cross-repo"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-05-28T15:42:14Z",
    "updated_at": "2026-05-31T05:45:58Z"
  }
}

Additional Context

A PR adding this exact catalog entry is already open and has had review feedback applied:

• Catalog entry: feat(catalog): add linear extension to community catalog #2749 — download_url pinned to the immutable v0.2.0 tag; tag aligned to issue-tracking per Copilot review.
• Docs table row: docs(community): list spec-kit-linear in community extensions table #2750

Filing this issue per maintainer guidance to use the Extension Submission template.