openspec-archive-change

Archive completed experimental changes with the OpenSpec CLI.

40|84|Updated Oct 4, 2022
One-click install
npx skills add https://github.com/mendix/web-widgets --skill openspec-archive-change-mendix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-archive-change
Source: https://github.com/mendix/web-widgets/tree/main/.agents/skills/openspec-archive-change
Command: npx skills add https://github.com/mendix/web-widgets --skill openspec-archive-change-mendix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the finalization and archival of completed experimental changes, ensuring proper validation and safe relocation into an archive directory.

Core Features & Use Cases

  • Change selection and validation: Prompts for an active change when not provided and checks artifact and task completion before archiving.
  • Delta spec assessment: Evaluates any delta specs against main specs to determine syncing needs and generate a clear summary for the user.
  • Safe archiving and reporting: Creates an archive path, preserves metadata, moves the change, and provides a concise completion summary.

Quick Start

Archive the change you just implemented by running the OpenSpec archive command with the desired change name.

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 experimental changes using OpenSpec?

Archiving delta specs in OpenSpec involves evaluating the delta specs against main specs to determine syncing needs, verifying that all related tasks and artifacts are complete, and then relocating the change folder into a safe archive path.

What happens to delta specs when I archive an OpenSpec change?

When archiving an OpenSpec change, the system assesses delta specs against main specs to determine syncing needs, verifies artifact and task completion, and generates a clear summary before safely relocating the change into an archive directory.

Can I archive an OpenSpec change without specifying the change name?

Yes, if a change name is not provided, the OpenSpec archive process prompts you to select an active change, verifies its artifact and task completion, evaluates delta specs, and then safely archives the completed experimental change.

Does OpenSpec verify task completion before archiving a change?

Yes, OpenSpec enforces guardrails by verifying artifact and task completion before archiving, ensuring that only fully completed experimental changes are safely relocated to the archive directory with a concise summary output.

When should I archive experimental changes in the OpenSpec workflow?

You should archive experimental changes in the OpenSpec workflow once all artifacts and tasks are completed, allowing the system to assess delta specs against main specs and safely relocate the finalized change into an archive directory.