openspec-sync-specs

Merge delta specification changes into main specification files for the openspec CLI.

2|Updated Nov 14, 2024
One-click install
npx skills add https://github.com/fkoschi/grind-it --skill openspec-sync-specs-fkoschi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/fkoschi/grind-it/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/fkoschi/grind-it --skill openspec-sync-specs-fkoschi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of updating main specification files with changes defined in delta specification files, ensuring consistency and reducing manual effort in managing evolving requirements.

Core Features & Use Cases

  • Intelligent Merging: Applies changes from delta specs to main specs, handling additions, modifications, removals, and renames of requirements intelligently.
  • Change Management: Facilitates the synchronization of specifications without archiving changes, allowing for iterative updates.
  • Use Case: When a new feature is developed, its specification changes can be captured in a delta spec. This Skill then merges those specific changes into the main specification document, preserving existing content.

Quick Start

Use the openspec-sync-specs skill to sync changes from the 'new-feature-branch' into the main specifications.

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 specification files into main specification files?

To merge delta specification files into main specification files, you need a tool that intelligently synchronizes requirement additions, modifications, removals, and renames. This process automates updating main specs with changes, ensuring consistency and reducing manual effort in managing evolving requirements.

What is delta specification synchronization and when do I need it?

Delta specification synchronization is the process of applying changes from delta specs into main specification documents. You need it when developing new features, allowing you to capture specification changes iteratively and merge them into main specs while preserving existing content.

Do I need the openspec CLI to sync delta specs?

Yes, you need the openspec CLI to sync delta specs because the synchronization process requires it to list and manage changes and specifications. The tool acts as a dependency for intelligently merging requirement additions, modifications, and removals within specified capabilities.

How do I sync requirement changes from a new feature branch into main specifications?

To sync requirement changes from a new feature branch into main specifications, you apply changes defined in delta specification files. This merges specific additions, modifications, removals, and renames into the main specification document, facilitating synchronization without archiving changes.

Does merging delta specs preserve existing content in main specification files?

Yes, merging delta specs preserves existing content in main specification files. The synchronization process intelligently applies requirement additions, modifications, removals, and renames from delta specs into the main specification document without overwriting unchanged existing content.