openspec-bulk-archive-change

Archive multiple completed openspec changes in a single batch operation.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/soyrochus/vulgata --skill openspec-bulk-archive-change-soyrochus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/soyrochus/vulgata/tree/main/.claude/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/soyrochus/vulgata --skill openspec-bulk-archive-change-soyrochus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the repetitive and error-prone process of archiving multiple completed openspec changes, ensuring delta specs are synchronized and conflicts are resolved before moving change directories to an archive.

Core Features & Use Cases

  • Batch selection & confirmation: Prompt-driven multi-select to choose which changes to archive, with a single confirmation step for the entire batch.
  • Comprehensive validation: Collects artifact status, task completion, and delta spec contents for each change to determine readiness.
  • Conflict detection & resolution: Detects capability-level spec conflicts across selected changes, inspects the codebase for implementation evidence, and resolves conflicts by implementation status or chronological order.
  • Spec sync and archival: Optionally syncs delta specs to main specs, preserves metadata, and moves change directories into a dated archive while tracking success, skips, and failures.
  • Use Case: Repository maintainers who need to clean up multiple parallel changes and ensure the canonical specs reflect what is actually implemented.

Quick Start

Use the openspec-bulk-archive-change skill to select multiple completed changes, resolve any spec conflicts by inspecting the codebase, and archive them in a single confirmed operation.

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 multiple completed openspec changes at once?

To batch archive openspec changes, use a prompt-driven multi-select to choose completed changes, then confirm the entire batch. The operation validates artifacts, syncs delta specs, resolves conflicts, and moves directories into a dated archive.

What happens when parallel openspec changes have conflicting delta specs?

When delta specs conflict, the system inspects the codebase for implementation evidence and resolves conflicts by implementation status or chronological order, ensuring canonical specs reflect the actual implemented codebase state.

How do I sync delta specs to main specs before archiving openspec changes?

Spec sync occurs automatically during the batch archival process. After validation and conflict resolution, the tool optionally syncs delta specs to main specs while preserving metadata before moving change directories.

Can I archive openspec changes that still have incomplete tasks or missing artifacts?

Archiving requires completed tasks and artifacts. The batch operation collects artifact status and task completion data for each change to determine readiness, skipping changes that fail these comprehensive validation checks.

What is the best way to clean up multiple parallel openspec change directories?

The best way to clean up parallel change directories is a coordinated batch archive that detects capability conflicts, inspects implementation evidence, syncs specs, and tracks success, skips, and failures across the entire batch.

Why does bulk archiving openspec changes require conflict resolution?

Bulk archiving requires conflict resolution because parallel changes often modify overlapping capabilities. Detecting and resolving these spec conflicts by implementation status or chronological order ensures the canonical specs accurately reflect the merged codebase.