openspec-sync-specs

Merging delta specs safely requires applying changes intelligently instead of wholesale replacements. This tool reads delta files and updates main specs incrementally, preserving untouched content while prompting for input on ambiguous modifications to prevent data loss.

Delta specification synchronization works by enforcing guardrails and prompting for user input when changes are ambiguous. This ensures all updates to main specs are intentional and prevents accidental overwrites during the merge process.

Yes, the openspec CLI is required to execute the sync process. The tool reads delta specifications from the openspec/changes directory and merges them into main specs under openspec/specs, creating new files and scaffolding sections when needed.

When a main spec file is missing during a delta merge, the sync tool automatically creates it and scaffolds the initial Requirements section. This ensures new specifications are properly structured before applying the delta changes.

Yes, you can sync RENAMED changes alongside ADDED, MODIFIED, and REMOVED operations. The tool applies all these delta change types to update main specs accurately while preserving existing content not mentioned in the delta.