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.