speckit-sync-apply

Apply approved drift proposals to Specify specs and generate alignment tasks.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-sync-apply-b0yz4kr14
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-sync-apply
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-sync-apply
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-sync-apply-b0yz4kr14

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns reviewed, approved drift proposals into real spec updates and actionable implementation tasks, so your Specify specs and downstream code stay aligned without manual, error-prone edits.

Core Features & Use Cases

  • Applies approved drift resolutions: Reads .specify/sync/proposals.json, filters approved: true, and updates existing spec files for BACKFILL changes.
  • Creates new specs from NEW_SPEC proposals: Generates the required specs/{spec-id}/ structure with a spec.md and a tasks.md placeholder.
  • Generates alignment work for ALIGN proposals: Does not modify code directly; instead it produces .specify/sync/align-tasks.md (and can optionally create GitHub issues via options).
  • Handles supersede workflows: Adds superseded_by metadata and links new specs from old ones for deprecated flows.
  • Produces audit artifacts: Writes an apply report to .specify/sync/apply-report.md and .specify/sync/apply-report.json, with backups stored in .specify/sync/backups/.

Quick Start

Run the apply workflow in dry-run mode to preview exactly what would be updated from the approved proposals in .specify/sync/proposals.json.

Frequently Asked Questions about speckit-sync-apply

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

FAQPage Schema
How do I apply approved spec drift resolutions to my Specify specs?

To apply approved spec drift resolutions, run the apply workflow against your `.specify/` project structure to process `approved: true` entries from `.specify/sync/proposals.json. It updates spec content and generates implementation tasks for spec-to-code alignment.

What does a dry-run preview for spec sync proposal apply actually change?

A dry-run preview for spec sync proposal apply does not change anything. It simulates applying approved proposals from `.specify/sync/proposals.json` to show exactly what spec updates and implementation tasks would be generated without modifying files.

How do I generate implementation tasks for spec-to-code alignment from approved proposals?

Implementation tasks for spec-to-code alignment are generated automatically when applying ALIGN proposals. The process creates an `align-tasks.md` file in the `.specify/sync/` directory to track required code updates without modifying the codebase directly.

Can I automatically commit spec updates when applying drift resolutions?

Yes, you can automatically commit spec updates by using the `--auto-commit` option when running the apply workflow. This handles the file changes from approved proposals and commits them directly to your version control system.

Does applying spec drift resolutions create backups of the original spec files?

Yes, applying spec drift resolutions creates backups of the original spec files automatically. These backups are stored in the `.specify/sync/backups/` directory alongside apply reports in Markdown and JSON formats for complete audit tracking.

How do supersede workflows handle deprecated spec directories?

Supersede workflows handle deprecated spec directories by adding `superseded_by` metadata to the old spec and linking the new replacement spec. This ensures deprecated flows are tracked while generating the new `specs/{spec-id}/` structure.