openspec-bulk-archive-change

Batch-archive completed OpenSpec changes with conflict resolution and status reports.

Updated Mar 9, 2025
One-click install
npx skills add https://github.com/rock-hu/vitamin-compose --skill openspec-bulk-archive-change-rock-hu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/rock-hu/vitamin-compose/tree/main/.qwen/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/rock-hu/vitamin-compose --skill openspec-bulk-archive-change-rock-hu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive multiple completed OpenSpec changes in a single operation, simplifying batch maintenance and ensuring consistent archiving.

Core Features & Use Cases

  • Batch archiving of multiple changes in one run, preserving their history under openspec/changes/archive with date-stamped folders.
  • Conflict-aware processing: detects overlapping delta specs across chosen changes and resolves according to codebase evidence.
  • Audit-ready output: provides consolidated status and optional resolution notes for each archived change.

Quick Start

Run the batch archive workflow to process all active changes with OpenSpec and produce a summary report.

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?

You can batch-archive multiple OpenSpec changes by running a single operation that processes active changes, resolves conflicts, and stores them in date-stamped archive folders. This simplifies batch maintenance and ensures consistent archiving.

How does batch archiving handle conflicting delta specs across changes?

Batch archiving detects overlapping delta specs across chosen changes and resolves conflicts based on codebase evidence. It enforces defined conflict resolution rules and generates optional resolution notes for each archived change.

Can I preserve existing YAML metadata when archiving OpenSpec changes?

Yes, the batch archival operation preserves existing YAML metadata while archiving changes under date-stamped directories. This ensures historical configuration data remains intact during the batch maintenance process.

What is included in the status report for batch-archived OpenSpec changes?

The batch archiving process generates per-change status reports and consolidated audit-ready output. These reports include archival status and optional resolution notes for conflicts detected during the operation.

When should I use batch archiving instead of archiving OpenSpec changes individually?

Batch archiving is best when you have multiple ready-to-archive OpenSpec changes and need consistent processing. It evaluates artifacts, tasks, and delta specs together, resolving conflicts in a single run rather than manually.

Does batch archiving evaluate tasks and artifacts before moving OpenSpec changes?

Yes, the batch archival workflow evaluates artifacts, tasks, and delta specs for chosen changes before archiving. This ensures only completed changes are processed and moved to the archive directory.