openspec-archive-change

Archive completed OpenSpec changes after validating artifacts, tasks, and delta-spec synchronization.

33|5|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized --skill openspec-archive-change-thelegendtubaguy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized/tree/main/.pi/skills/openspec-archive-change
Command: npx skills add https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized --skill openspec-archive-change-thelegendtubaguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archiving completed OpenSpec changes within experimental workflows is error-prone and hard to audit. This skill provides a guided, auditable process to move a finished change from active planning areas into a structured archive, preserving provenance and artifacts.

Core Features & Use Cases

  • Guided change selection or prompting when a name is not provided
  • Validation of artifact and task completion before archiving
  • Delta-spec synchronization assessment and reporting
  • Date-based, collision-checked archive naming under planningHome.changesDir/archive
  • Summary reporting of archive results and any warnings

Quick Start

Provide the change name or allow the tool to prompt for selection, then initiate the archive workflow to move the change into the archive directory.

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 safely?

To archive completed OpenSpec changes safely, you validate artifact completion, task status, and delta-spec synchronization before moving the changeRoot into a structured, date-stamped archive directory to preserve provenance.

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

When archiving an OpenSpec change with incomplete tasks or artifacts, the process prompts you to address the missing items before proceeding, ensuring only fully validated and synchronized changes are moved into the archive.

How does the OpenSpec archive process handle naming conflicts?

The OpenSpec archive process prevents naming conflicts by creating a date-stamped, collision-checked archive path under the planningHome.changesDir/archive directory, ensuring each archived change receives a unique location.

Do I need the OpenSpec CLI to archive completed change artifacts?

Yes, you need the OpenSpec CLI environment to archive completed change artifacts, as the process requires its infrastructure to validate status JSON, determine readiness, and execute the changeRoot relocation.

What is delta-spec synchronization and why is it checked before archiving?

Delta-spec synchronization assessment verifies that your change specifications are fully aligned before archiving, ensuring the archived artifacts accurately reflect the final state of your completed workflow planning.

Can I select which active change to archive if I do not provide a name?

If you do not provide a change name, the archiving workflow prompts you to select from active changes across your projects, guiding you through the validation and relocation process for the chosen item.