openspec-archive-change

Archive completed OpenSpec changes to the archive directory after validation gates pass.

63|6|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/xiayu519/Tyou --skill openspec-archive-change-xiayu519
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/xiayu519/Tyou/tree/main/.agents/skills/openspec-archive-change
Command: npx skills add https://github.com/xiayu519/Tyou --skill openspec-archive-change-xiayu519

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archive a completed OpenSpec change to the archive directory when all gates pass, ensuring artifacts and tasks are complete and delta specs are synced as needed.

Core Features & Use Cases

  • Archiving completed changes to openspec/changes/archive/YYYY-MM-DD-<name>/ after verification.
  • Validating artifact and task completion and optionally syncing delta specs before archiving.
  • Providing a guardrail-driven workflow with clear summaries of what happened and where it was archived.

Quick Start

When a change is ready, run the archive workflow to move the change into the archive directory and confirm the results.

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?

You can archive completed OpenSpec changes by running the archive workflow, which enforces artifact and task completion checks and delta spec synchronization before moving files to the archive directory.

What validation gates must pass before archiving an OpenSpec change?

Before archiving an OpenSpec change, completion gates require finished tasks, completed artifacts, and synced delta specs to ensure safe archival and traceability.

Where are archived OpenSpec change files stored?

Archived OpenSpec change files are stored in the openspec/changes/archive/YYYY-MM-DD-<name>/ directory after all completion gates pass verification.

What happens if delta specs are not synced before archiving an OpenSpec change?

If delta specs are not synced, the OpenSpec archive workflow assesses synchronization status and can optionally sync them before proceeding to ensure safe archival and traceability.

Can I archive an OpenSpec change with incomplete tasks or artifacts?

No, you cannot archive an OpenSpec change with incomplete tasks or artifacts. The workflow enforces change selection and validates that all completion gates pass before archival.

Why does my OpenSpec change archive process fail during validation?

The OpenSpec archive process fails during validation if completion gates detect unfinished artifacts, incomplete tasks, or unsynced delta specs that prevent safe archival.