openspec-sync-specs

To merge delta specs into main specs, read delta files from openspec/changes and apply added, modified, removed, or renamed requirements to update or create corresponding main specs while preserving existing unmentioned content.

The best way to apply delta specification changes safely is using an automated, idempotent merge process that propagates updates into canonical main specs without creating duplicates or archiving the original delta changes.

Idempotent spec synchronization works by ensuring repeated merge runs converge to the same main specs, applying delta file updates with minimal manual intervention and without duplicating existing specification content.

Yes, you can update modified and renamed requirements while preserving existing content, because the merge process only applies changes explicitly mentioned in the delta specs and leaves unmentioned canonical content untouched.

The sync process reads delta specs from the openspec/changes/<name>/specs/*/spec.md file path structure to locate and extract the requirement changes needed for updating the main specifications.