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.