Verified:GitHub

spk-gate-merge

Merge accepted Spec Kitty missions while preserving git invariants and mission state.

1.6k|156|Updated Oct 9, 2025

Search Tags:#worktree #git merge #spec-kitty #acceptance gate #spec-Driven Development #mission lifecycle

One-click install

npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-gate-merge

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: spk-gate-merge
Source: https://github.com/Priivacy-ai/spec-kitty/tree/main/src/charter/offering/skills/spk-gate-merge
Command: npx skills add https://github.com/Priivacy-ai/spec-kitty --skill spk-gate-merge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Merging an accepted Spec Kitty mission involves git worktree state, mission lifecycle records, and post-merge follow-through; doing it ad hoc risks losing audit trails or merging unreviewed work. This Skill enforces a safe, ordered merge gate.

Core Features & Use Cases

Acceptance Verification: Confirms the mission passed the accept gate before any merge is attempted.
Guided Merge Execution: Runs the /spec-kitty.merge command or equivalent CLI and resolves git/worktree blockers via the git workflow skill.
Post-Merge Routing: Automatically routes to mission review and retrospective steps after the merge completes.
Use Case: After a work package passes acceptance review, use this Skill to merge it into the main branch, then proceed directly to the mission review and retrospective without skipping governance steps.

Quick Start

Merge the currently accepted Spec Kitty mission and continue to the mission review and retrospective steps.

Frequently Asked Questions about spk-gate-merge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I merge an accepted Spec Kitty mission?▼

Confirm the mission passed the accept gate, then run the /spec-kitty.merge command or the equivalent CLI command. After merging, proceed to the mission review and retrospective steps to complete the workflow.

What happens if git worktree issues block a Spec Kitty merge?▼

Resolve git or worktree blockers using the spk-admin-git-workflow skill before retrying the merge. The merge gate does not bypass worktree conflicts; they must be cleaned up first.

Can I merge a mission that failed acceptance review?▼

No. The merge gate explicitly forbids merging rejected, blocked, or partially reviewed work. The mission must pass the accept step before any merge is attempted.

What steps come after merging a Spec Kitty mission?▼

After a successful merge, the workflow routes to the mission review step and then to the retrospective step. These post-merge gates preserve the audit trail and capture lessons learned.