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.