openspec-sync-specs

Merge delta specs into main specs with interactive guardrails.

39|6|Updated Apr 22, 2025
One-click install
npx skills add https://github.com/danielsogl/copilot-workflow-demo --skill openspec-sync-specs-danielsogl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/danielsogl/copilot-workflow-demo/tree/main/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/danielsogl/copilot-workflow-demo --skill openspec-sync-specs-danielsogl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs into main specs can be error-prone and time-consuming. This skill automates the careful merge process to apply changes without archiving the delta, ensuring traceable and idempotent updates.

Core Features & Use Cases

  • Intelligent delta-to-main spec merging that preserves existing content not mentioned in the delta.
  • Per-capability updates: adds, modifies, or renames requirements based on delta specs with minimal disruption.
  • Guarded workflow: prompts for user input when choices are needed and validates results to prevent unintended changes.

Quick Start

Follow the delta spec merge workflow to apply delta specs to the main specs and review the resulting specs.

Frequently Asked Questions about openspec-sync-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge delta specs into main specs without losing existing requirements?

To merge delta specs into main specs without losing existing requirements, apply changes per-capability to add, modify, or rename requirements while preserving unrelated content. This deterministic merge updates the main specs idempotently without archiving the delta.

What is a delta spec workflow for change management?

A delta spec workflow for change management tracks incremental requirement changes separately in a delta directory, then merges them into main capability specs. This preserves traceability and allows guarded, interactive updates before finalizing modifications.

Can I automate applying spec changes from a delta folder to my main specs?

Yes, you can automate applying spec changes from a delta folder to main specs. The process reads delta structures and idempotently updates main capability specs, prompting for user input only when choices are needed to prevent unintended changes.

Does merging delta specs modify or archive the original delta files?

Merging delta specs does not archive or delete the original delta files. It applies the added, modified, or renamed requirements directly to the main specs, ensuring the changes are traceable while keeping the delta intact for reference.

How does interactive merging handle conflicting requirement updates?

Interactive merging handles conflicting requirement updates by enforcing guardrails that prompt for user input when needed. This validates results and prevents unintended changes, ensuring deterministic and idempotent updates to the main specs.