Skip to content

luno/spec-kit-preset-jira

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

spec-kit-preset-jira

Spec Kit Version License Issues

Spec Kit preset that overrides speckit.taskstoissues to create Jira epics, stories, and tasks instead of GitHub Issues.

Why a Preset?

The core speckit.taskstoissues command is hardcoded to GitHub Issues — it checks for a GitHub remote and uses the GitHub MCP server. For teams using Jira, the natural /speckit.taskstoissues workflow is unusable.

Extensions cannot override core commands due to the speckit.{ext-id}.{command} naming requirement. Presets sit higher in the resolution stack and can replace core commands directly, keeping the natural workflow intact.

See github/spec-kit#2223 for the full discussion.

What It Does

Overrides the core speckit.taskstoissues command so that /speckit.taskstoissues creates a Jira issue hierarchy:

  • Epic — created from the feature name in spec.md
  • Stories/Tasks — one per task in tasks.md, linked to the epic
  • Sub-tasks — for tasks with sub-items
  • Issue links — dependency relationships from tasks.md are wired as "Blocks"/"is blocked by" links

Installation

specify preset add jira --from https://github.com/luno/spec-kit-preset-jira/archive/refs/heads/main.zip

Or install from a local clone:

git clone https://github.com/luno/spec-kit-preset-jira.git
specify preset add --dev ./spec-kit-preset-jira

Prerequisites

This preset requires an Atlassian MCP server connection with access to:

  • createJiraIssue
  • createIssueLink
  • getVisibleJiraProjects
  • getJiraProjectIssueTypesMetadata
  • searchJiraIssuesUsingJql

Configuration

The target Jira project is resolved in this order:

  1. User input — pass a project key as an argument: /speckit.taskstoissues CPB
  2. Preset config — set project_key in .specify/presets/jira/jira-config.yml:
    project_key: "CPB"
  3. Environment variable — set SPECKIT_JIRA_PROJECT_KEY=CPB
  4. Interactive — prompted to select from available projects

Compatibility

This preset works alongside the existing spec-kit-jira extension. The preset handles the core workflow override, while the extension can provide supplementary commands like discover-fields and sync-status.

Overrides

Core Command Override
speckit.taskstoissues Creates Jira issues instead of GitHub Issues

Links

License

MIT

About

Spec Kit preset that overrides speckit.taskstoissues to create Jira issues instead of GitHub Issues

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors