openspec-archive-change

Archive completed OpenSpec changes into date-stamped directories after validating statuses.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/yjzaaa/learn-claude-code-my --skill openspec-archive-change-yjzaaa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/yjzaaa/learn-claude-code-my/tree/main/.github/skills/openspec-archive-change
Command: npx skills add https://github.com/yjzaaa/learn-claude-code-my --skill openspec-archive-change-yjzaaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed OpenSpec changes into a structured, date-based archive to keep the workflow history organized and auditable.

Core Features & Use Cases

  • Active-change selection prompts for choosing the change to archive when not provided.
  • Status validation automatically checks artifact completion, task completion, and delta-spec sync state before archiving.
  • Safe archive moves the change into openspec/changes/archive/YYYY-MM-DD-<name>, preserving relevant metadata and enabling easy rollback or review.

Quick Start

Archive a completed change by selecting a change name (if needed), verify artifacts and tasks are complete, optionally sync delta specs, and move the change directory to openspec/changes/archive/YYYY-MM-DD-<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 to keep workflow history organized?▼

To archive completed OpenSpec changes, select an active change, verify artifact and task completion, assess delta spec synchronization, and move the change directory to openspec/changes/archive/YYYY-MM-DD-<name> for safe storage and easy rollback.

What happens if I try to archive an OpenSpec change with incomplete tasks?▼

Archiving OpenSpec changes requires status validation. The workflow automatically checks artifact completion, task completion, and delta-spec sync state via openspec status before allowing the change directory to move to the archive.

How does delta spec synchronization affect archiving completed changes?▼

Delta spec synchronization is assessed during the archival workflow. If a delta spec is present, the process validates its synchronization state before the change is safely moved to the openspec/changes/archive/YYYY-MM-DD-<name> directory.

Can I archive an OpenSpec change without specifying the change name?▼

Yes, you can archive an OpenSpec change without specifying the name initially. The workflow enforces guardrails by prompting for active-change selection when the change name is missing or not explicitly provided.

What is the directory structure for archived OpenSpec changes?▼

Archived OpenSpec changes use a structured, date-based directory format. The original change directory is moved to openspec/changes/archive/YYYY-MM-DD-<name>, preserving relevant metadata and enabling easy review or rollback.