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.