openspec-sync-specs

To merge delta specifications into main specs, apply added, modified, removed, and renamed requirements from delta files into the corresponding main spec files while preserving untouched content. This synchronization produces an idempotent summary of all applied changes.

Delta spec synchronization is a change management process that propagates approved requirement edits from change folders into canonical documentation. It aligns active deltas with main specs without manually reconstructing every requirement, ensuring repeatable merged results.

You update capability specs by applying delta changes that include added, modified, removed, and renamed requirements. The merge process identifies the active change if unspecified, applies the deltas into main spec files, and generates an idempotent summary of updates.

Yes, spec synchronization is idempotent, meaning rerunning the merge process on the same delta and main spec files produces the same merged result. This supports repeatable synchronization so you can safely apply updates multiple times.

When syncing delta specs, untouched requirements in the main specification files are preserved. The merge process only applies added, modified, removed, and renamed requirements from the delta files, leaving all other canonical content intact.

When a specific change is not provided, the change selection workflow helps you identify and choose the correct active change from available changes. This ensures the right delta specs are applied to the corresponding main spec files during synchronization.