Skip to content

[codex] add worktree-first specify command#8

Merged
dango85 merged 2 commits into
mainfrom
codex/worktree-first-specify
May 4, 2026
Merged

[codex] add worktree-first specify command#8
dango85 merged 2 commits into
mainfrom
codex/worktree-first-specify

Conversation

@dango85
Copy link
Copy Markdown
Owner

@dango85 dango85 commented May 4, 2026

Summary

Adds an explicit worktree-first specify command for the workflow discussed in issue #4: create or reuse the feature worktree before writing any spec artifacts, then continue the normal Spec Kit flow from that worktree root.

Why

The existing after_specify hook creates a worktree only after /speckit.specify has already written artifacts in the primary checkout. A raw before_specify hook can create a worktree, but it does not guarantee Spec Kit will switch the active project root for the rest of the command. This PR documents and exposes the predictable command-level workflow instead.

Changes

  • Add /speckit.worktrees.specify command instructions.
  • Register the new command in extension.yml.
  • Document the worktree-first VS Code flow in the README.
  • Add an Unreleased changelog entry.

Existing PR check

Checked #7 first: tests are green and GitHub reports it as mergeable. It is still marked BLOCKED by GitHub, which appears to be repository policy/review state rather than a code conflict.

Validation

  • bash tests/test-create-worktree.sh
  • bash tests/test-post-install.sh
  • ruby -e 'require "yaml"; YAML.load_file("extension.yml")'
  • git diff --check

Closes #4

@dango85 dango85 marked this pull request as ready for review May 4, 2026 04:06
@dango85 dango85 merged commit 210aaf3 into main May 4, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Experience using it with VisualStudio Code

1 participant