openspec-archive-change

Archive completed changes from an experimental workflow to a persistent directory.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/opensoft/dartwing-ocr-pipeline --skill openspec-archive-change-opensoft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/opensoft/dartwing-ocr-pipeline/tree/main/.gemini/skills/openspec-archive-change
Command: npx skills add https://github.com/opensoft/dartwing-ocr-pipeline --skill openspec-archive-change-opensoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed changes in an experimental workflow to preserve a clear history and keep active workspaces uncluttered.

Core Features & Use Cases

  • Provides an auditable, step-by-step process to move finished changes from active development to an archive folder, including artifact and task status checks.
  • Enforces explicit user selection for the change to archive, prompts for confirmation when incomplete items are detected, and records the archiving outcome.
  • Performs delta-spec synchronization checks when delta specs exist and optionally syncs before archiving, with a concise post-archive summary.

Quick Start

Run openspec archive-change for a specific change to begin the archival workflow.

Frequently Asked Questions about openspec-archive-change

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive a completed change in an experimental workflow?

To archive a completed change, the workflow validates artifact and task completion, checks delta-spec synchronization, and moves the change to a persistent archive directory with a summary. You select the specific change, confirm any incomplete items, and the process records the archival outcome.

What happens if incomplete tasks are detected during change archival?

If incomplete tasks are detected during change archival, the workflow prompts for explicit user confirmation before proceeding. It enforces this selection step to ensure you intentionally acknowledge any unfinished artifacts before moving the change to the archive directory.

Do I need the OpenSpec CLI to archive experimental changes?

Yes, you need the OpenSpec CLI available in your environment to archive experimental changes. The archival workflow relies on this CLI to validate artifact statuses, check delta-spec synchronization, and move completed changes to a persistent archive.

How does delta-spec synchronization work when archiving a change?

Delta-spec synchronization checks run when delta specs exist for the change being archived. The workflow verifies synchronization status and optionally syncs the delta specs before moving the change to the archive directory, ensuring spec consistency.

What is the best way to keep active workspaces uncluttered after finishing a change?

The best way to keep active workspaces uncluttered is to archive completed changes to a persistent archive folder. This process moves finished changes out of the active experimental workflow, preserving a clear history while validating artifact and task completion.

Can I archive a change without validating artifact and task completion?

No, you cannot skip validation; the workflow checks for artifact and task completion before archiving. If incomplete items are found, it prompts for explicit confirmation, ensuring you acknowledge the status before the change is moved to the archive.