openspec-archive-change

Archive completed openspec changes after validating artifacts and delta specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the finalization and archival of completed changes in an experimental openspec workflow, removing manual checks and file moves and ensuring the change is recorded with context and warnings.

Core Features & Use Cases

  • Interactive Change Selection: Prompts the user to choose an active change if no name is provided, preventing accidental archives.
  • Artifact and Task Validation: Uses openspec status JSON and a local tasks file to surface incomplete artifacts and tasks and requests confirmation before proceeding.
  • Delta Spec Assessment and Sync: Compares delta specs under openspec/changes/<name>/specs to main specs and summarizes adds/modifications/removals, offering sync or skip options and invoking a sync task if requested.
  • Safe Archive Operation: Creates an archive folder, ensures target names do not conflict, moves the change directory into openspec/changes/archive/YYYY-MM-DD-<name>, and preserves metadata files.
  • Clear Summary and Guardrails: Reports the schema, archive location, sync status, and any warnings; always asks the user before proceeding when uncertainties exist.

Quick Start

Archive the change 'my-change' by selecting it when prompted, confirm any warnings about incomplete artifacts or tasks, sync delta specs if recommended, and proceed to move the change to openspec/changes/archive/YYYY-MM-DD-my-change.

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 openspec changes safely, the workflow validates artifacts and tasks, compares delta specs to main specs, and moves the change directory to openspec/changes/archive/YYYY-MM-DD-<name> while prompting for user confirmation on any uncertainties.

What happens to incomplete tasks during openspec change archival?

During openspec change archival, the process surfaces incomplete artifacts and tasks using openspec status JSON and a local tasks file, then explicitly requests user confirmation before proceeding with the archive operation to prevent data loss.

How do I sync delta specs before archiving an openspec change?

To sync delta specs before archiving an openspec change, the workflow compares delta specs under openspec/changes/<name>/specs to main specs, summarizes additions, modifications, and removals, and offers sync or skip options by invoking a sync task if requested.

Do I need the openspec CLI to finalize and archive changes?

Yes, the openspec CLI is required to finalize and archive changes because the workflow depends on parsing openspec status JSON output and requires read/write access to openspec/changes and openspec/specs directories to verify artifacts and prepare archival.

Can I choose which active change to archive in openspec?

Yes, you can choose which active change to archive in openspec, as the workflow provides interactive change selection and prompts the user to select a specific change if no name is provided, preventing accidental archives of the wrong change.

Why does my archived openspec change have warnings in the summary?

Archived openspec change summaries include warnings when the workflow detects incomplete artifacts, unresolved tasks, or sync status uncertainties during the archival process, ensuring all contextual issues are recorded for long-term reference.