openspec-bulk-archive-change

Batch-archive completed OpenSpec changes with conflict-aware validation.

1|Updated May 7, 2024
One-click install
npx skills add https://github.com/sitdownkevin/blog-next --skill openspec-bulk-archive-change-sitdownkevin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-bulk-archive-change
Source: https://github.com/sitdownkevin/blog-next/tree/main/.cursor/skills/openspec-bulk-archive-change
Command: npx skills add https://github.com/sitdownkevin/blog-next --skill openspec-bulk-archive-change-sitdownkevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Batch-archive completed OpenSpec changes to streamline change management and reduce manual overhead.

Core Features & Use Cases

  • Batch archive: archive multiple changes in a single operation, with conflict-aware validation.
  • Status-driven workflow: checks artifact status, tasks, and delta specs to ensure only eligible changes are archived.
  • Audit-friendly archiving: preserves metadata and organizes archived changes by date, while optionally syncing specs before archiving.

Quick Start

Select active changes, review their status, and run a single batch archive to move them into the archive folder.

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 OpenSpec changes at once?

Batch archiving OpenSpec changes involves reading active-change statuses, checking task completion, resolving delta spec conflicts by analyzing the codebase, and moving eligible changes into a dated archive folder. This reduces manual overhead by processing multiple changes in a single operation.

What happens when delta specs conflict during OpenSpec change archiving?

When delta specs conflict during archiving, the system inspects the conflicts and resolves them by analyzing the codebase to verify implementation status. It syncs specs when implemented and preserves the .openspec.yaml file before prompting for selection and confirmation.

Can I archive OpenSpec changes if their tasks are not fully completed?

No, archiving requires completed tasks and artifacts. The workflow checks artifact status, tasks, and delta specs to ensure only eligible changes are archived. You must resolve incomplete items before proceeding with the batch archive operation.

What is the best way to manage multiple parallel OpenSpec changes ready for archiving?

Use batch-archive functionality to handle multiple parallel changes in a single operation. It validates completion status, inspects delta specs for conflicts, resolves conflicts via codebase analysis, syncs specs, and organizes archived changes by date in openspec/changes/archive/YYYY-MM-DD-<name>.

Does OpenSpec archiving preserve project metadata and configuration?

Yes, the archiving process preserves the .openspec.yaml file and maintains metadata for audit purposes. Archived changes are organized by date in the archive folder, ensuring traceability and audit-friendly change management.

Why does my OpenSpec batch archive fail on some changes but not others?

Batch archive failures typically occur when specific changes have incomplete tasks, unresolved artifact statuses, or delta spec conflicts. The system checks each change individually, and only eligible changes with verified completion and resolved conflicts proceed to archiving.