openspec-archive-change

Archive completed OpenSpec changes after validating delta-spec synchronization.

39|6|Updated Apr 22, 2025
One-click install
npx skills add https://github.com/danielsogl/copilot-workflow-demo --skill openspec-archive-change-danielsogl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/danielsogl/copilot-workflow-demo/tree/main/.github/skills/openspec-archive-change
Command: npx skills add https://github.com/danielsogl/copilot-workflow-demo --skill openspec-archive-change-danielsogl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive completed changes in the OpenSpec workflow to finalize work and preserve a traceable record.

Core Features & Use Cases

  • Finalizes and archives a completed change after all artifacts are done.
  • Validates delta-spec alignment with main specs and generates a concise archival summary.
  • Provides guardrails to prompt for selection when a change is not specified and to report any warnings without blocking the archive.

Quick Start

Initiate the archive of a completed change by running the openspec archive command after ensuring all artifacts are complete and delta specs are aligned.

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 changes in OpenSpec to preserve a traceable record?▼

To archive completed OpenSpec changes, ensure all artifacts are finished and delta-specs are aligned, then run the openspec archive command. This finalizes the workflow and generates a concise archival summary for auditing purposes.

What does it mean to finalize an OpenSpec change after artifact completion?▼

Finalizing an OpenSpec change involves validating that artifact status is complete and delta-specs are synchronized with main specs. The archive process then securely stores the record, providing a traceable audit trail of the completed work.

Do I need the openspec CLI to archive completed change management workflows?▼

Yes, the openspec CLI is required to archive completed changes. You also need appropriate permissions to execute the archival process, which validates artifact status and delta-spec synchronization before finalizing the work.

What happens if delta-spec synchronization fails before archiving an OpenSpec change?▼

If delta-spec synchronization validation fails, the OpenSpec change cannot be archived until alignment with main specs is corrected. The process checks this prerequisite before proceeding to generate an archival summary.

Can I archive an OpenSpec change without specifying which change to finalize?▼

No, when a specific change is not provided, the archive process includes guardrails to prompt for selection. This ensures the correct completed change is targeted before validating its artifact status and synchronizing delta-specs.

Does archiving OpenSpec changes block the workflow if there are warnings?▼

No, archiving OpenSpec changes reports any warnings without blocking the archive process. This allows you to finalize and securely preserve the traceable record while remaining informed of potential issues.