What problem does it solve?
It prevents completed AI coding changes from being finalized without verifying artifacts, tasks, spec synchronization, and (when enabled) the corresponding GitLab workflow state.
Core Features & Use Cases
- Worktree-aware change resolution: Selects the correct change using
openspec list --json, and when isolation is enabled, discovers changes inside registered git worktrees before archiving.
- Completion validation and safety checks: Uses
openspec status --change ... --json, warns on incomplete artifacts, and optionally checks tasks.md for remaining work.
- Delta spec sync and GitLab workflow updates: Assesses whether delta specs exist and prompts for syncing; when
.gitlab.yaml is present and glab is available, updates child and parent issue labels to move workflow forward without closing issues.
- Long-term memory and wiki extraction (optional): If
memory/ and wiki/ exist, extracts reusable patterns and session summaries via corgispec-memory-extract, then syncs wiki logs and indices.
- Archival movement and cleanup: Moves the change into
openspec/changes/archive/YYYY-MM-DD-<name>/ and removes the git worktree when isolation is active.
Quick Start
Run the corgispec-archive-change skill and provide the change name when you are ready to finalize it, otherwise let it infer or prompt you to select from available changes.