openspec-archive-change

name	openspec-archive-change
description	Archives a completed OpenSpec change into openspec/changes/archive/, after confirming artifact and task completion and offering to sync any delta specs into the main specs first. Use for "archive this change", "finalize <change>", or "this is done, wrap it up". Warns but does not block on incomplete artifacts or tasks — the user decides whether to proceed anyway.
compatibility	Requires the openspec CLI on PATH.

Archive an OpenSpec change

Move a change from active to archived, confirming completeness and offering to sync its delta specs into the long-lived main specs first.

Steps

1. Select the change. If not given, run openspec list --json, show only active (non-archived) changes with their schema, and let the user choose. Never guess.

2. Check artifact completion: openspec status --change "<name>" --json — read schemaName and each artifact's status. If any are not done, show a warning listing them and confirm the user wants to proceed anyway.

3. Check task completion. Read the tasks file (typically tasks.md), count - [ ] vs - [x]. If incomplete tasks exist, warn with the count and confirm before proceeding. No tasks file means no warning needed.

4. Assess delta spec sync state. Check openspec/changes/<name>/specs/. If delta specs exist, compare each against its main spec at openspec/specs/<capability>/spec.md, determine what would change, and show a combined summary before offering: "Sync now (recommended)" vs "Archive without syncing" (or, if already synced, "Archive now" / "Sync anyway" / "Cancel"). If the user chooses sync, delegate via the Task tool (subagent_type: general-purpose) with the prompt "Invoke /openspec-sync-specs for change ''" plus the analyzed delta summary — then archive regardless of the sync choice made.

5. Perform the archive:

   mkdir -p openspec/changes/archive
   mv openspec/changes/<name> openspec/changes/archive/YYYY-MM-DD-<name>
   

   Use the current date. If the target directory already exists, fail with an error and suggest renaming the existing archive or using a different date. .openspec.yaml moves with the directory automatically.

6. Display a summary: change name, schema, archive location, whether specs were synced, and any warnings from steps 2-3.

Output

## Archive Complete

**Change:** <change-name>
**Schema:** <schema-name>
**Archived to:** openspec/changes/archive/YYYY-MM-DD-<name>/
**Specs:** synced to main specs / no delta specs / sync skipped

Guardrails

• Always prompt for change selection if not given — never auto-select.
• Warnings inform and require confirmation; they never silently block.
• Preserve .openspec.yaml when moving to archive.
• If delta specs exist, always run the sync assessment and show the combined summary before prompting, regardless of the user's eventual choice.

Completion

Complete when the change directory has moved to openspec/changes/archive/YYYY-MM-DD-<name>/, any chosen spec sync has run, and the summary — including every warning surfaced along the way — has been shown to the user.