openspec-archive-change

Archive finished openspec changes into date-stamped directories with metadata preservation.

9|16|Updated Oct 16, 2018
One-click install
npx skills add https://github.com/ondata/albopopTwoDotZero --skill openspec-archive-change-ondata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/ondata/albopopTwoDotZero/tree/main/.gemini/skills/openspec-archive-change
Command: npx skills add https://github.com/ondata/albopopTwoDotZero --skill openspec-archive-change-ondata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, structured method to archive finished OpenSpec changes, preserving configuration and history while keeping the working directory clean.

Core Features & Use Cases

  • Archive a finished openspec change into a date-stamped directory under openspec/changes/archive, ensuring important metadata (.openspec.yaml) is preserved.
  • Validate artifact statuses and task completion before archiving, surfacing warnings without blocking the operation.
  • Assess delta spec synchronization with main specs and optionally perform a sync prior to archiving.
  • Provide a clear archiving summary including change name, archive location, and whether syncing occurred.
  • Use cases include finalizing experimental changes after implementation and handing off archived records for audit.

Quick Start

Archive a completed openspec change by providing its name and confirming artifact and task completion when prompted.

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 while preserving workflow history?

To archive completed openspec changes, you finalize the change into a date-stamped directory under openspec/changes/archive. This preserves the .openspec.yaml metadata and history while keeping the working directory clean for future reference.

What is the best way to validate artifact status before archiving openspec changes?

Validating artifact status before archiving uses the openspec CLI to check task completion. The process surfaces warnings about incomplete artifacts without blocking the archiving operation, ensuring safe finalization of experimental workflow changes.

How do I sync delta specs with main specs prior to archiving an openspec change?

Syncing delta specs before archiving involves assessing synchronization between delta specs and main specs. The archiving process optionally performs a sync prior to the move and provides a summary indicating whether syncing occurred.

Does archiving openspec changes require the openspec CLI for status checks?

Archiving openspec changes relies on the openspec CLI to perform artifact status checks and execute the directory moves. The CLI enforces the date-based archive path and preserves the .openspec.yaml configuration during the operation.

What metadata is preserved when moving finished openspec changes to the archive directory?

When moving finished openspec changes to the archive directory, the .openspec.yaml metadata file is preserved. The archive path is date-based, ensuring structured history and enabling auditability of experimental workflow changes.

Can I archive openspec changes if artifact status validation surfaces warnings?

You can archive openspec changes even if artifact status validation surfaces warnings. The process checks artifact statuses and task completion before archiving but does not block the operation, allowing finalization while flagging potential issues.