openspec-archive-change

Archive OpenSpec changes by moving completed change directories under openspec/changes/archive with a date-stamped folder, preserving the original .openspec.yaml metadata to prevent rework and maintain traceability.

When archiving an OpenSpec change, the original .openspec.yaml metadata is preserved during the move to the archive directory, ensuring the change history and configuration remain intact for future reference.

Validate artifacts and task status before archiving by running the openspec status command, which checks completion states and informs you of any pending items that need resolution prior to archiving.

Yes, if no change name is provided, the archiving tool prompts you to select one from the list of active OpenSpec changes, then guides you through artifact and task checks before completing the archive process.

Yes, the OpenSpec archive process optionally syncs delta specs during archiving, ensuring any incremental specification updates are synchronized before the completed change is moved to the archive directory.

Avoid archiving OpenSpec changes when artifact or task checks via openspec status indicate incomplete items, as archiving unfinished changes can lead to lost work and break the traceability of your project history.