openspec-bulk-archive-change

Batch-archive completed OpenSpec changes into a date-stamped archive.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/zdpk/skills --skill openspec-bulk-archive-change-zdpk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/zdpk/skills/tree/main/dotfiles/skills/custom/openspec/openspec-bulk-archive-change
Command: npx skills add https://github.com/zdpk/skills --skill openspec-bulk-archive-change-zdpk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed changes in a batch to reduce clutter and preserve history within OpenSpec workflows.

Core Features & Use Cases

  • Batch-archive multiple changes into a date-stamped archive directory, keeping main specs clean.
  • Detect and resolve conflicts by inspecting delta specs and evidence from the codebase, applying an ordered resolution.
  • Ensure task lists, artifact states, and specs are consolidated before archiving, with per-change status reporting.

Quick Start

Archive all eligible OpenSpec changes in a single operation by running the bulk archive flow.

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 batch-archive completed OpenSpec changes to reduce clutter?

To batch-archive OpenSpec changes, validate artifact statuses across openspec/changes, read tasks, enumerate delta specs, and move approved changes into a single date-stamped archive directory. This preserves configuration files and generates a per-change status report.

How does conflict resolution work when archiving multiple OpenSpec delta specs?

Conflict resolution for delta specs detects overlapping changes by inspecting code evidence and chronology, then applies a deterministic ordered resolution strategy. This ensures conflicting delta specs are consolidated correctly before changes are archived.

What is the best way to consolidate task lists and artifact states before archiving OpenSpec changes?

Consolidating task lists and artifact states involves validating the status of artifacts within openspec/changes and reading associated tasks. The bulk archive workflow enforces this consolidation to ensure only approved changes are archived with status reporting.

Does the bulk archive process preserve the .openspec.yaml configuration file?

Yes, the bulk archiving process preserves the .openspec.yaml configuration file when moving completed changes to the archive directory. This ensures the archived change retains its necessary OpenSpec workflow configuration.

When should I not use batch archiving for OpenSpec changes?

You should avoid batch archiving when individual changes have unresolved artifact statuses or unapproved tasks. The workflow strictly archives only changes approved for archival, enforcing user prompts to prevent moving incomplete work into the date-stamped archive.