sync-spec-kit

name

sync-spec-kit

description

Synchronize the spec folder with the current state of implementation on a feature branch. Use this skill when the user says "sync spec", "update spec", "spec is outdated", "reflect changes in spec", "update the plan", "sync specification", "keep spec up to date", "spec drift", or any variation of wanting to reconcile implementation changes back into the spec-kit specification files (spec.md, plan.md, tasks.md, research.md, etc.).

sync-spec-kit Skill

Keep the spec-kit specification folder (.specify/specs/<feature>/) in sync with the actual implementation on a feature branch.

---

Workflow

Step 1: Validate context

1. Check the current branch:

git branch --show-current

2. If the branch is main or master, stop immediately and tell the user:

   "Spec sync only runs on feature branches. You're currently on main. Switch to your feature branch first."

3. Derive the feature name from the branch. Strip common prefixes (feature/, feat/, bugfix/, fix/, hotfix/, chore/, refactor/) and use the remainder.

Step 2: Locate the spec folder

1. List available spec folders:

ls .specify/specs/

2. Match the feature name to a spec folder (exact match first, then fuzzy). If no match, list available specs and ask the user which one to sync.

Step 3: Delegate to the sync-spec-kit-agent

Once the branch and spec folder are confirmed, launch the using the Agent tool. Pass it the following context in the prompt: