openspec-archive-change

Archive completed OpenSpec change directories after validating artifacts and tasks.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/daodaoedu/daodao --skill openspec-archive-change-daodaoedu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/daodaoedu/daodao/tree/main/.gemini/skills/openspec-archive-change
Command: npx skills add https://github.com/daodaoedu/daodao --skill openspec-archive-change-daodaoedu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the finalization and archival of experimental OpenSpec changes by validating artifacts and tasks, assessing delta spec sync state, and moving completed change directories into a dated archive location so teams can reliably retire finished work without losing context.

Core Features & Use Cases

  • Interactive change selection: Prompts the user to choose an active change when no name is provided, preventing accidental archives.
  • Validation and warnings: Checks artifact completion via openspec status and inspects task files for incomplete items, requiring confirmation before proceeding.
  • Delta spec assessment and optional sync: Compares delta specs against main specs, summarizes proposed changes, and offers an option to sync before archiving.
  • Safe archival: Creates a date-prefixed archive folder and moves the change directory, with checks to avoid name collisions and to preserve .openspec.yaml.

Quick Start

Archive the change 'feature-x' after verifying artifacts and tasks, confirm or skip syncing delta specs, and move the change to openspec/changes/archive with a date-prefixed name.

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 completed OpenSpec changes and verify task completion before finalizing?

To archive OpenSpec changes, validate artifact completion via openspec status, inspect task files for incomplete items, and move the directory to openspec/changes/archive with a date prefix. The process requires user confirmation to prevent accidental archival of unfinished work.

What is the process to sync delta specs against main specs before archiving an OpenSpec change?

Syncing delta specs involves comparing delta specs against main specs to summarize proposed changes. The archival process offers an option to sync these spec differences before moving the change directory to a dated archive location for safe retirement.

Can I use openspec CLI to list active changes and select one for archival without specifying a name?

Yes, when no change name is provided, the archival process prompts you to interactively select an active change. It uses openspec list and openspec status JSON output to validate artifacts and tasks before proceeding with the archive operation.

What's the best way to prevent accidental archival of incomplete OpenSpec experimental changes?

To prevent accidental archival, the process checks artifact completion via openspec status and inspects task files for incomplete items. It requires explicit user confirmation before moving any change directory into the dated archive location.

Does OpenSpec archival preserve configuration files like .openspec.yaml when moving changes to the archive folder?

Yes, the OpenSpec archival process preserves the .openspec.yaml file when moving the change directory. It creates a date-prefixed archive folder and includes checks to avoid name collisions during the repository file operations.

Why do I need openspec CLI access and JSON output for archiving OpenSpec change directories?

Openspec CLI access is required to run openspec list and status commands for JSON output, which validates artifact completion and task states. This JSON data drives the validation checks needed before performing repository file operations to move changes into the archive.