You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
After the bundled GitHub Issues extension is available and the core /speckit.taskstoissues command has completed a deprecation period, retaining both implementations leaves GitHub-specific project-management behavior in the core SDD command set and creates duplicate maintenance surfaces.
The final migration stage should make the extension the sole owner of GitHub issue creation.
Proposed Solution
After #4421 and #4422 have shipped in earlier minor releases, remove taskstoissues from the core command set.
The removal should cover all core-owned surfaces, including:
The core command template.
Core command inventories, ordering, and descriptions.
Integration scaffolding and generated core command expectations.
Agent-specific argument descriptions and tool declarations.
Tests that assume taskstoissues is always installed as a core command.
README, installation, integration, and upgrade documentation.
The bundled github-issues extension should become the sole implementation and continue to provide speckit.github-issues.taskstoissues.
Once the core namespace is free, add speckit.taskstoissues as a deprecated compatibility alias in the extension if the extension command and alias validation rules support it safely. The namespaced command remains canonical. Projects without the extension should no longer receive any tasks-to-issues command.
Document the breaking change prominently and provide an agent-consumable migration recipe:
The exact refresh command should be verified against the supported upgrade flow before publication.
Alternatives Considered
Retain the deprecated core command indefinitely: Leaves provider-specific functionality and duplicate maintenance in core.
Auto-install the extension for everyone: Preserves behavior but defeats the goal of making issue tracking opt-in.
Remove the core command without a compatibility alias: Simpler, but unnecessarily disrupts users who have installed the replacement extension and still invoke the legacy name.
Component
Specify CLI (initialization, commands)
AI Agent (if applicable)
All agents
Use Cases
New projects receive only the core SDD workflow unless they explicitly opt into GitHub issue tracking.
GitHub issue functionality can evolve and release independently as an extension.
Other issue-tracker providers can offer parallel extensions without replacing a core command.
This issue removes the command from core after the deprecation window.
Spec Kit's current release guidance treats the version as a release identifier rather than a promise that breaking changes require a new major version. The removal may therefore ship in a minor release, provided it is clearly identified and documented as breaking.
Problem Statement
After the bundled GitHub Issues extension is available and the core
/speckit.taskstoissuescommand has completed a deprecation period, retaining both implementations leaves GitHub-specific project-management behavior in the core SDD command set and creates duplicate maintenance surfaces.The final migration stage should make the extension the sole owner of GitHub issue creation.
Proposed Solution
After #4421 and #4422 have shipped in earlier minor releases, remove
taskstoissuesfrom the core command set.The removal should cover all core-owned surfaces, including:
taskstoissuesis always installed as a core command.The bundled
github-issuesextension should become the sole implementation and continue to providespeckit.github-issues.taskstoissues.Once the core namespace is free, add
speckit.taskstoissuesas a deprecated compatibility alias in the extension if the extension command and alias validation rules support it safely. The namespaced command remains canonical. Projects without the extension should no longer receive any tasks-to-issues command.Document the breaking change prominently and provide an agent-consumable migration recipe:
The exact refresh command should be verified against the supported upgrade flow before publication.
Alternatives Considered
Component
Specify CLI (initialization, commands)
AI Agent (if applicable)
All agents
Use Cases
Acceptance Criteria
taskstoissuesis removed from the core command templates and inventories.github-issuesis installed.speckit.github-issues.taskstoissuescommand.speckit.taskstoissuesextension alias is provided if it can be registered safely after the core command is removed.before_taskstoissuesandafter_taskstoissuescontinue to function when the extension command runs.Additional Context
This is stage 3 of the migration:
Spec Kit's current release guidance treats the version as a release identifier rather than a promise that breaking changes require a new major version. The removal may therefore ship in a minor release, provided it is clearly identified and documented as breaking.
Related discussion: #4370, especially #4370 (comment).