spec-kitty

How to Accept and Merge a Feature

Use this guide to validate feature readiness and merge to main.

Prerequisites

All WPs are in lane: "done"
You are in the feature worktree

Accept the Feature

In your agent:

/spec-kitty.accept

Or in your terminal:

spec-kitty accept

What Accept Checks

All WPs are in done
Required metadata and activity logs are present
No unresolved [NEEDS CLARIFICATION] markers remain

To run a read-only checklist (in your terminal):

spec-kitty accept --mode checklist

Merge to Main

In your agent:

/spec-kitty.merge --push

Or in your terminal:

spec-kitty merge --push

For detailed merge options including dry-run, strategies, and cleanup flags, see Merge a Feature.

Merge Strategies

Default (merge commit): spec-kitty merge
Squash: spec-kitty merge --strategy squash

Note: Rebase is not supported for workspace-per-WP features. Use merge or squash instead.

Cleanup

By default, merge removes the feature worktree and deletes the feature branch. Use these flags to keep them (in your terminal):

spec-kitty merge --keep-worktree --keep-branch

Abandon a Feature (Manual Cleanup)

If you decide to drop a feature without merging, remove its worktrees and branches manually. These steps are safe and reversible until you delete the branch and commit the cleanup.

List worktrees to find all workspaces for the feature:
```
git worktree list
```

Remove each feature worktree:

git worktree remove .worktrees/<feature>-WP01
git worktree remove .worktrees/<feature>-WP02

If a worktree has uncommitted changes you want to discard, use --force:

git worktree remove --force .worktrees/<feature>-WP01

Delete the feature branches:

git branch -D <feature>-WP01
git branch -D <feature>-WP02

Remove the planning artifacts from main (spec/plan/tasks), then commit:

rm -rf kitty-specs/<feature>
git add kitty-specs/
git commit -m "Remove abandoned feature <feature>"

Troubleshooting

Accept reports blockers: Resolve the listed issues, then rerun /spec-kitty.accept.
Merge fails: Ensure your worktree is clean and you are on the feature branch.

For detailed troubleshooting including pre-flight failures, conflict resolution, and merge recovery, see Troubleshoot Merge Issues.

Command Reference

Slash Commands - All /spec-kitty.* commands
CLI Commands - Full CLI reference

Background

Workspace-per-WP Model - Worktree cleanup
Git Worktrees - How worktrees work

Getting Started

Your First Feature - Complete workflow walkthrough

This site is open source. Improve this page.