archive

Archive a completed change and update the main specifications.

openspec archive [change-name] [options]

Description

This is the final step of the workflow. It:

  1. Verifies that all tasks in tasks.md are marked complete.
  2. Validates the change structure.
  3. Applies Deltas: Reads specs/ in the change folder and merges ADDED/MODIFIED/REMOVED requirements into the main files in openspec/specs/.
  4. Moves the change directory to openspec/changes/archive/YYYY-MM-DD-[name]/.

Options

  • --yes, -y: Skip confirmation prompts (useful for CI/CD).
  • --skip-specs: Archive the change without updating any specs (use for tooling/docs-only changes).
  • --no-validate: Force archive even if validation fails (requires confirmation unless --yes is used).