openspec-bulk-archive-change

Archives multiple completed OpenSpec changes in one batch with conflict-aware spec syncing.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/germainlefebvre4/cvwonder-forms --skill openspec-bulk-archive-change-germainlefebvre4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/germainlefebvre4/cvwonder-forms/tree/main/.gemini/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/germainlefebvre4/cvwonder-forms --skill openspec-bulk-archive-change-germainlefebvre4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Archiving many completed OpenSpec changes one at a time is repetitive and error-prone, especially when several changes touch the same capability specs. This Skill batches the entire archive workflow, detects spec conflicts between changes, and resolves them by checking what is actually implemented in the codebase. ## Core Features & Use Cases - Batch archiving: Lists all active changes, lets the user multi-select any number, and archives them in a single confirmed operation with per-change outcome tracking. - Conflict detection and resolution: Maps capabilities to the changes that touch them, then inspects the codebase to decide which delta specs to sync, applying both-implemented conflicts in chronological order. - Verified spec sync: Runs the openspec-sync-specs workflow inline for included deltas and verifies main specs before moving any change into the archive directory. - Use Case: After finishing three parallel feature branches (OAuth, project config, schema management), select all three, review the consolidated status table, confirm once, and archive them with specs merged correctly. ## Quick Start Ask the assistant to bulk archive your completed OpenSpec changes and choose which ones to include when prompted.

Frequently Asked Questions about openspec-bulk-archive-change

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

FAQPage Schema
How do I archive multiple OpenSpec changes at once?

Run the bulk archive workflow, which lists all active changes via openspec list and prompts you to multi-select the ones to archive. After reviewing a consolidated status table, you confirm once and every selected change is archived with its delta specs synced.

How are spec conflicts resolved when two changes touch the same capability?

The workflow builds a capability-to-changes map and flags any capability touched by two or more changes. It then searches the codebase for implementation evidence: if only one change is implemented, only its specs sync; if both are implemented, they apply in chronological order.

Does bulk archive work with OpenSpec stores?

Yes. If the work lives in a registered store, the workflow runs openspec store list --json to discover store ids and passes --store <id> to the commands that read or write specs and changes. Without a store, commands act on the nearest local openspec root.

What happens if a change has incomplete tasks during bulk archive?

Incomplete changes appear with warnings in the status table showing unfinished artifacts and task counts. At confirmation you can archive everything, archive only ready changes and skip the rest, or cancel the entire batch.

Why did a delta spec get skipped during archiving?

A delta spec is excluded from sync when conflict resolution finds no implementation evidence for it in the codebase. The change itself can still be archived, and each excluded delta is reported as sync skipped with the change, capability, and reason.