openspec-bulk-archive-change

Archive multiple completed OpenSpec changes and reconcile delta specs.

139|27|Updated Nov 9, 2014
One-click install
npx skills add https://github.com/nfe/client-nodejs --skill openspec-bulk-archive-change-nfe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/nfe/client-nodejs/tree/main/.github/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/nfe/client-nodejs --skill openspec-bulk-archive-change-nfe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you archive multiple completed OpenSpec changes at once while avoiding incorrect spec merges and handling conflicts based on what is actually implemented in the codebase.

Core Features & Use Cases

  • Multi-change batch workflow: Lists active changes and lets you select one or many to archive in a single operation.
  • Status consolidation: For each selected change, checks artifact completion, task checklist progress, and which delta spec requirements are present.
  • Conflict detection and resolution: Detects capability-spec conflicts across selected changes, then investigates the codebase to decide whether to sync specs from one or multiple changes (including chronological ordering when both are implemented).
  • User-confirmed execution: Shows warnings for incomplete changes and asks for a single final confirmation before archiving anything.
  • Robust outcome reporting: Tracks success, failures (e.g., existing archive directories), and skips, and summarizes spec-sync activity.

Quick Start

Run the OpenSpec CLI and follow the prompts to select the active changes you want to archive in a single batch.

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 completed OpenSpec changes at once without causing spec sync conflicts?

Batch-archive multiple OpenSpec changes by running the CLI to list active changes, select finished ones, and reconcile delta spec requirements against main specs. The workflow detects cross-change capability conflicts and resolves them using codebase evidence before moving changes into a dated archive directory.

How does spec conflict resolution work when archiving parallel OpenSpec changes?

Spec conflict resolution detects capability-spec conflicts across selected changes, then investigates the codebase to decide whether to sync specs from one or multiple changes. It applies chronological ordering when both conflicting changes are already implemented, prompting the user for final selection and confirmation.

Can I archive OpenSpec changes that still have incomplete task checklists or missing delta specs?

Yes, you can archive incomplete OpenSpec changes, but the batch workflow checks artifact completion, task checklist progress, and delta spec presence for each selected change. It displays warnings for incomplete changes and requires a single final confirmation before proceeding with the archive operation.

What happens if an OpenSpec archive directory already exists when batch archiving changes?

When an existing archive directory is encountered during batch archiving, the operation tracks it as a failure. The robust outcome reporting summarizes successes, failures, and skips, while detailing the spec-sync activity that completed successfully before the error occurred.

Do I need to manually check task completion status before batch archiving OpenSpec specs?

No, manual checks are unnecessary before batch archiving OpenSpec specs. The status consolidation feature automatically checks artifact completion, task checklist progress, and which delta spec requirements are present for each selected change, presenting warnings so you can make informed decisions.

What's the best way to reconcile delta spec requirements against main specs before archiving?

The best way to reconcile delta spec requirements is using automated batch archiving with smart conflict resolution. It reads each change's tasks.md and delta specs, resolves conflicts via codebase evidence, and syncs specs from one or multiple changes based on chronological implementation order before final archiving.