feat: add modifies_hooks to disable git before_specify on install

Declares modifies_hooks in extension.yml so that installing this extension
automatically disables the git extension's before_specify -> speckit.git.feature
hook (with explicit user consent). This keeps the primary checkout on a stable
branch while worktrees handle feature branch isolation.

Requires: github/spec-kit#2209 (modifies_hooks support)
Made-with: Cursor

Author: Abishek Yadav

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.1.0 (2026-04-13)
+
+### Added
+- `modifies_hooks` declaration: automatically disables `before_specify -> speckit.git.feature` on install (with user consent) so the primary checkout stays on a stable branch
+- Requires Spec Kit with `modifies_hooks` support ([github/spec-kit#2209](https://github.com/github/spec-kit/pull/2209))
+
 ## 1.0.0 (2026-04-13)
 
 ### Added

README.md

@@ -65,10 +65,29 @@ dotworktrees_dir: ".worktrees"
 | `/speckit.worktrees.list` | Dashboard: status, artifacts, tasks | No |
 | `/speckit.worktrees.clean` | Remove merged/stale worktrees | Yes |
 
-## Hook
+## Hooks
 
 **`after_specify`** — automatically creates a worktree after a new feature is specified. Controlled by the `auto_create` config value.
 
+## Hook overrides
+
+This extension declares `modifies_hooks` in `extension.yml` to **disable** the git extension's `before_specify -> speckit.git.feature` hook on install. This keeps the primary checkout on a stable branch (e.g. `main`) while worktrees handle feature branch isolation.
+
+During `specify extension add`, you will see a consent prompt:
+
+```
+Extension 'worktrees' requests the following hook modifications:
+
+  Hook                Target Extension  Command               Action   Reason
+  before_specify      git               speckit.git.feature   disable  Worktree-parallel keeps primary checkout...
+
+Apply these modifications? [Y/n]:
+```
+
+Answering **Y** disables the hook. Answering **N** installs the extension without modifying hooks (you can disable it manually in `.specify/extensions.yml`). Removing the extension via `specify extension remove worktrees` restores the original hook state.
+
+**Requires**: Spec Kit with `modifies_hooks` support (see [github/spec-kit#2209](https://github.com/github/spec-kit/pull/2209)).
+
 ## Script usage
 
 The bash script can be called directly for automation:

extension.yml

@@ -3,7 +3,7 @@ schema_version: "1.0"
 extension:
   id: worktrees
   name: "Worktrees"
-  version: "1.0.0"
+  version: "1.1.0"
   description: "Default-on worktree isolation for parallel agents — sibling or nested layout"
   author: "dango85"
   repository: "https://github.com/dango85/spec-kit-worktree-parallel"
@@ -39,6 +39,13 @@ hooks:
     optional: false
     description: "Auto-spawn a worktree after a new feature is specified"
 
+modifies_hooks:
+  - hook: before_specify
+    extension: git
+    command: speckit.git.feature
+    action: disable
+    reason: "Worktree-parallel keeps primary checkout on a stable branch (e.g. main); branch creation is handled by git worktree add -b during after_specify"
+
 tags:
   - "worktree"
   - "git"