openspec-sync-specs

To merge delta specs into main specs, apply ADDED, MODIFIED, REMOVED, and RENAMED changes from openspec/changes to openspec/specs. This updates main specifications while preserving existing content and avoiding unintended deletions.

When a main spec does not exist during delta spec synchronization, the process automatically creates a new main spec file. It applies the delta changes directly to the new specification and outputs a human-readable summary of the updates.

The delta spec merge process intelligently applies MODIFIED and RENAMED changes by validating inputs to avoid unintended deletions. It preserves existing content in main specs while updating the specified requirements across openspec directories.

Yes, you can update main specs with only ADDED sections from a delta spec. The merge process supports applying individual change types like ADDED, MODIFIED, REMOVED, or RENAMED independently while preserving the original main spec content.

The best way to synchronize openspec changes without losing content is to use an automated delta spec merge. It reads delta and main specs, intelligently applies changes, and validates inputs to prevent unintended data loss during the update.

A delta spec sync outputs a human-readable summary of updates to provide visibility into how ADDED, MODIFIED, REMOVED, and RENAMED changes were applied to the main specs. This helps track exactly what content was altered or created.