openspec-bulk-archive-change

Archive multiple completed OpenSpec changes with conflict detection and spec syncing.

Updated Nov 12, 2025
One-click install
npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-bulk-archive-change-artagon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/artagon/artagon-vscode-profiles/tree/main/agents/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-bulk-archive-change-artagon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec.

What problem does it solve?

It reduces the risk and tedium of archiving several OpenSpec changes by batching them, detecting conflicts, and syncing specs based on what is actually implemented in your codebase.

Core Features & Use Cases

  • Batch archive with conflict detection: Select multiple completed changes, identify spec conflicts by capability, and resolve them using codebase evidence.
  • Implementation-aware spec syncing: Sync delta specs to main specs only when corresponding implementation is found, and apply chronological order when both sides are implemented.
  • Clear per-change reporting: Produces a consolidated status table, shows conflict resolutions and warnings, and summarizes archived/skipped/failed outcomes.

Quick Start

Use the openspec-bulk-archive-change skill to archive several completed OpenSpec changes in one run by selecting them from the prompted multi-select list.

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 without causing spec conflicts?

Batch archiving OpenSpec changes detects spec conflicts by capability and resolves them using codebase evidence. It syncs delta specs to main specs only when implementation is found, applying chronological order when both sides are implemented.

What happens if one change fails during a bulk OpenSpec archive operation?

Bulk archive operations use failure isolation to ensure that if one change fails, others continue processing. The tool produces a consolidated status table summarizing archived, skipped, and failed outcomes per change.

Can I sync OpenSpec delta specs based on what is actually implemented in my codebase?

Implementation-aware spec syncing checks your codebase for corresponding implementation before applying delta specs to main specs. This ensures only verified deltas are synced, preventing unimplemented changes from altering your main specs.

Do I need the openspec CLI to archive completed spec changes in bulk?

Yes, the openspec CLI is required. Bulk archiving relies on openspec CLI commands and JSON parsing to inspect delta specs, detect conflicts by capability, and execute date-based move operations into an archive directory.

How does conflict detection work when archiving several OpenSpec changes simultaneously?

Conflict detection identifies overlapping spec modifications by capability across selected changes. It resolves conflicts using implementation-based evidence from your codebase and syncs applicable deltas in chronological order when both sides are implemented.

What is the best way to finalize multiple parallel OpenSpec changes that are completed?

Use a bulk archive tool to select multiple completed changes from a prompted multi-select list. It prepares a per-change outcome plan, handles task completion validation, and moves change directories into an archive with clear reporting.