spec-kit/CHANGELOG.md

Changelog

[0.4.0] - 2026-03-23

Changes

• fix(cli): add allow_unicode=True and encoding="utf-8" to YAML I/O (#1936)

• fix(codex): native skills fallback refresh + legacy prompt suppression (#1930)

• feat(cli): embed core pack in wheel for offline/air-gapped deployment (#1803)

• ci: increase stale workflow operations-per-run to 250 (#1922)

• docs: update publishing guide with Category and Effect columns (#1913)

• fix: Align native skills frontmatter with install_ai_skills (#1920)

• feat: add timestamp-based branch naming option for specify init (#1911)

• docs: add Extension Comparison Guide for community extensions (#1897)

• docs: update SUPPORT.md, fix issue templates, add preset submission template (#1910)

• Add support for Junie (#1831)

• feat: migrate Codex/agy init to native skills workflow (#1906)

• chore: bump version to 0.3.2 (#1909)

• feat(extensions): add verify-tasks extension to community catalog (#1871)

• feat(presets): add enable/disable toggle and update semantics (#1891)

• feat: add iFlow CLI support (#1875)

• feat(commands): wire before/after hook events into specify and plan templates (#1886)

• docs(catalog): add speckit-utils to community catalog (#1896)

• docs: Add Extensions & Presets section to README (#1898)

• chore: update DocGuard extension to v0.9.11 (#1899)

• Update cognitive-squad catalog entry — Triadic Model, full lifecycle (#1884)

• feat: register spec-kit-iterate extension (#1887)

• fix(scripts): add explicit positional binding to PowerShell create-new-feature params (#1885)

• fix(scripts): encode residual JSON control chars as \uXXXX instead of stripping (#1872)

• chore: update DocGuard extension to v0.9.10 (#1890)

• Feature/spec kit add pi coding agent pullrequest (#1853)

• feat: register spec-kit-learn extension (#1883)

[0.3.2] - 2026-03-19

Changes

• chore: bump version to 0.3.2
• Add conduct extension to community catalog (#1908)

[0.3.1] - 2026-03-17

Changed

• chore: bump version to 0.3.1
• docs: add greenfield Spring Boot pirate-speak preset demo to README (#1878)
• fix(ai-skills): exclude non-speckit copilot agent markdown from skills (#1867)
• feat: add Trae IDE support as a new agent (#1817)
• feat(cli): polite deep merge for settings.json and support JSONC (#1874)
• feat(extensions,presets): add priority-based resolution ordering (#1855)
• fix(scripts): suppress stdout from git fetch in create-new-feature.sh (#1876)
• fix(scripts): harden bash scripts — escape, compat, and error handling (#1869)
• Add cognitive-squad to community extension catalog (#1870)
• docs: add Go / React brownfield walkthrough to community walkthroughs (#1868)
• chore: update DocGuard extension to v0.9.8 (#1859)
• Feature: add specify status command (#1837)
• fix(extensions): show extension ID in list output (#1843)
• feat(extensions): add Archive and Reconcile extensions to community catalog (#1844)
• feat: Add DocGuard CDD enforcement extension to community catalog (#1838)

[0.3.0] - 2026-03-13

Changed

• chore: bump version to 0.3.0
• feat(presets): Pluggable preset system with catalog, resolver, and skills propagation (#1787)
• fix: match 'Last updated' timestamp with or without bold markers (#1836)
• Add specify doctor command for project health diagnostics (#1828)
• fix: harden bash scripts against shell injection and improve robustness (#1809)
• fix: clean up command templates (specify, analyze) (#1810)
• fix: migrate Qwen Code CLI from TOML to Markdown format (#1589) (#1730)
• fix(cli): deprecate explicit command support for agy (#1798) (#1808)
• Add /selftest.extension core extension to test other extensions (#1758)
• feat(extensions): Quality of life improvements for RFC-aligned catalog integration (#1776)
• Add Java brownfield walkthrough to community walkthroughs (#1820)

[0.2.1] - 2026-03-11

Changed

• Added February 2026 newsletter (#1812)
• feat: add Kimi Code CLI agent support (#1790)
• docs: fix broken links in quickstart guide (#1759) (#1797)
• docs: add catalog cli help documentation (#1793) (#1794)
• fix: use quiet checkout to avoid exception on git checkout (#1792)
• feat(extensions): support .extensionignore to exclude files during install (#1781)
• feat: add Codex support for extension command registration (#1767)
• chore: bump version to 0.2.0 (#1786)
• fix: sync agent list comments with actual supported agents (#1785)
• feat(extensions): support multiple active catalogs simultaneously (#1720)
• Pavel/add tabnine cli support (#1503)
• Add Understanding extension to community catalog (#1778)
• Add ralph extension to community catalog (#1780)
• Update README with project initialization instructions (#1772)
• feat: add review extension to community catalog (#1775)
• Add fleet extension to community catalog (#1771)
• Integration of Mistral vibe support into speckit (#1725)
• fix: Remove duplicate options in specify.md (#1765)
• fix: use global branch numbering instead of per-short-name detection (#1757)
• Add Community Walkthroughs section to README (#1766)
• feat(extensions): add Jira Integration to community catalog (#1764)
• Add Azure DevOps Integration extension to community catalog (#1734)
• Fix docs: update Antigravity link and add initialization example (#1748)
• fix: wire after_tasks and after_implement hook events into command templates (#1702)
• make c ignores consistent with c++ (#1747)
• chore: bump version to 0.1.13 (#1746)
• feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
• feat: add verify extension to community catalog (#1726)
• Add Retrospective Extension to community catalog README table (#1741)
• fix(scripts): add empty description validation and branch checkout error handling (#1559)
• fix: correct Copilot extension command registration (#1724)
• fix(implement): remove Makefile from C ignore patterns (#1558)
• Add sync extension to community catalog (#1728)
• fix(checklist): clarify file handling behavior for append vs create (#1556)
• fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
• chore: bump version to 0.1.12 (#1737)
• fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
• fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
• fix: Split release process to sync pyproject.toml version with git tags (#1732)

[0.2.0] - 2026-03-09

Changed

• feat: add Kimi Code CLI agent support
• fix: sync agent list comments with actual supported agents (#1785)
• feat(extensions): support multiple active catalogs simultaneously (#1720)
• Pavel/add tabnine cli support (#1503)
• Add Understanding extension to community catalog (#1778)
• Add ralph extension to community catalog (#1780)
• Update README with project initialization instructions (#1772)
• feat: add review extension to community catalog (#1775)
• Add fleet extension to community catalog (#1771)
• Integration of Mistral vibe support into speckit (#1725)
• fix: Remove duplicate options in specify.md (#1765)
• fix: use global branch numbering instead of per-short-name detection (#1757)
• Add Community Walkthroughs section to README (#1766)
• feat(extensions): add Jira Integration to community catalog (#1764)
• Add Azure DevOps Integration extension to community catalog (#1734)
• Fix docs: update Antigravity link and add initialization example (#1748)
• fix: wire after_tasks and after_implement hook events into command templates (#1702)
• make c ignores consistent with c++ (#1747)
• chore: bump version to 0.1.13 (#1746)
• feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
• feat: add verify extension to community catalog (#1726)
• Add Retrospective Extension to community catalog README table (#1741)
• fix(scripts): add empty description validation and branch checkout error handling (#1559)
• fix: correct Copilot extension command registration (#1724)
• fix(implement): remove Makefile from C ignore patterns (#1558)
• Add sync extension to community catalog (#1728)
• fix(checklist): clarify file handling behavior for append vs create (#1556)
• fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
• chore: bump version to 0.1.12 (#1737)
• fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
• fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
• fix: Split release process to sync pyproject.toml version with git tags (#1732)

[0.1.14] - 2026-03-09

Added

• feat: add Tabnine CLI agent support
• Multi-Catalog Support (#1707): Extension catalog system now supports multiple active catalogs simultaneously via a catalog stack
  • New specify extension catalog list command lists all active catalogs with name, URL, priority, and install_allowed status
  • New specify extension catalog add and specify extension catalog remove commands for project-scoped catalog management
  • Default built-in stack includes catalog.json (default, installable) and catalog.community.json (community, discovery only) — community extensions are now surfaced in search results out of the box
  • specify extension search aggregates results across all active catalogs, annotating each result with source catalog
  • specify extension add enforces install_allowed policy — extensions from discovery-only catalogs cannot be installed directly
  • Project-level .specify/extension-catalogs.yml and user-level ~/.specify/extension-catalogs.yml config files supported, with project-level taking precedence
  • SPECKIT_CATALOG_URL environment variable still works for backward compatibility (replaces full stack with single catalog)
  • All catalog URLs require HTTPS (HTTP allowed for localhost development)
  • New CatalogEntry dataclass in extensions.py for catalog stack representation
  • Per-URL hash-based caching for non-default catalogs; legacy cache preserved for default catalog
  • Higher-priority catalogs win on merge conflicts (same extension id in multiple catalogs)
  • 13 new tests covering catalog stack resolution, merge conflicts, URL validation, and install_allowed enforcement
  • Updated RFC, Extension User Guide, and Extension API Reference documentation

[0.1.13] - 2026-03-03

Changed

• feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
• feat: add verify extension to community catalog (#1726)
• Add Retrospective Extension to community catalog README table (#1741)
• fix(scripts): add empty description validation and branch checkout error handling (#1559)
• fix: correct Copilot extension command registration (#1724)
• fix(implement): remove Makefile from C ignore patterns (#1558)
• Add sync extension to community catalog (#1728)
• fix(checklist): clarify file handling behavior for append vs create (#1556)
• fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
• chore: bump version to 0.1.12 (#1737)
• fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
• fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
• fix: Split release process to sync pyproject.toml version with git tags (#1732)

[0.1.13] - 2026-03-03

Fixed

• Copilot Extension Commands Not Visible: Fixed extension commands not appearing in GitHub Copilot when installed via specify extension add --dev
  • Changed Copilot file extension from .md to .agent.md in CommandRegistrar.AGENT_CONFIGS so Copilot recognizes agent files
  • Added generation of companion .prompt.md files in .github/prompts/ during extension command registration, matching the release packaging behavior
  • Added cleanup of .prompt.md companion files when removing extensions via specify extension remove
• Fixed a syntax regression in src/specify_cli/__init__.py in _build_ai_assistant_help() that broke ruff and pytest collection in CI.

[0.1.12] - 2026-03-02

Changed

• fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
• fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
• fix: Split release process to sync pyproject.toml version with git tags (#1732)

[0.1.10] - 2026-03-02

Fixed

• Version Sync Issue (#1721): Fixed version mismatch between pyproject.toml and git release tags
  • Split release process into two workflows: release-trigger.yml for version management and release.yml for artifact building
  • Version bump now happens BEFORE tag creation, ensuring tags point to commits with correct version
  • Supports both manual version specification and auto-increment (patch version)
  • Git tags now accurately reflect the version in pyproject.toml at that commit
  • Prevents confusion when installing from source

[0.1.9] - 2026-02-28

Changed

• Updated dependency: bumped astral-sh/setup-uv from 6 to 7

[0.1.8] - 2026-02-28

Changed

• Updated dependency: bumped actions/setup-python from 5 to 6

[0.1.7] - 2026-02-27

Changed

• Updated outdated GitHub Actions versions
• Documented dual-catalog system for extensions

Fixed

• Fixed version command in documentation

Added

• Added Cleanup Extension to README
• Added retrospective extension to community catalog

[0.1.6] - 2026-02-23

Fixed

• Parameter Ordering Issues (#1641): Fixed CLI parameter parsing issue where option flags were incorrectly consumed as values for preceding options
  • Added validation to detect when --ai or --ai-commands-dir incorrectly consume following flags like --here or --ai-skills
  • Now provides clear error messages: "Invalid value for --ai: '--here'"
  • Includes helpful hints suggesting proper usage and listing available agents
  • Commands like specify init --ai-skills --ai --here now fail with actionable feedback instead of confusing "Must specify project name" errors
  • Added comprehensive test suite (5 new tests) to prevent regressions

[0.1.5] - 2026-02-21

Fixed

• AI Skills Installation Bug (#1658): Fixed --ai-skills flag not generating skill files for GitHub Copilot and other agents with non-standard command directory structures
  • Added commands_subdir field to AGENT_CONFIG to explicitly specify the subdirectory name for each agent
  • Affected agents now work correctly: copilot (.github/agents/), opencode (.opencode/command/), windsurf (.windsurf/workflows/), codex (.codex/prompts/), kilocode (.kilocode/workflows/), q (.amazonq/prompts/), and agy (.agent/workflows/)
  • The install_ai_skills() function now uses the correct path for all agents instead of assuming commands/ for everyone

[0.1.4] - 2026-02-20

Fixed

• Qoder CLI detection: Renamed AGENT_CONFIG key from "qoder" to "qodercli" to match the actual executable name, fixing specify check and specify init --ai detection failures

[0.1.3] - 2026-02-20

Added

• Generic Agent Support: Added --ai generic option for unsupported AI agents ("bring your own agent")
  • Requires --ai-commands-dir <path> to specify where the agent reads commands from
  • Generates Markdown commands with $ARGUMENTS format (compatible with most agents)
  • Example: specify init my-project --ai generic --ai-commands-dir .myagent/commands/
  • Enables users to start with Spec Kit immediately while their agent awaits formal support

[0.0.102] - 2026-02-20

• fix: include 'src/**' path in release workflow triggers (#1646)

[0.0.101] - 2026-02-19

• chore(deps): bump github/codeql-action from 3 to 4 (#1635)

[0.0.100] - 2026-02-19

• Add pytest and Python linting (ruff) to CI (#1637)
• feat: add pull request template for better contribution guidelines (#1634)