What problem does it solve?
This Skill streamlines the finalization and archival of experimental changes managed by the openspec workflow, ensuring teams do not leave incomplete artifacts or unsynced delta specs when closing a change.
Core Features & Use Cases
- Guided Selection: Prompts the user to select an active change when no name is provided, preventing accidental archival of the wrong item.
- Completion Verification: Checks artifact completion via openspec status and scans task lists for unfinished tasks, asking for confirmation before proceeding.
- Delta Spec Assessment & Syncing: Detects delta specs, compares them to main specs, summarizes the diffs, and offers to sync changes before archiving.
- Safe Archival: Creates a dated archive folder, preserves metadata like .openspec.yaml, prevents overwriting existing archives, and reports a clear summary of actions and warnings.
- Use Case: A developer finalizing a feature change can validate artifacts and tasks, optionally sync specification updates, and reliably move the change to openspec/changes/archive with auditability.
Quick Start
Archive the change named add-user-auth by prompting to select it, validating artifacts and tasks, optionally syncing delta specs, and moving the folder into openspec/changes/archive.
