comet-archive

Original：🇨🇳 Chinese

Translated

Comet Phase 5: Archive. Invoke with /comet-archive. Sync delta spec to main spec and archive the change.

6installs

Sourcerpamis/comet

Added on2026-05-27

NPX Install

npx skill4agent add rpamis/comet comet-archive

SKILL.md Content (Chinese)

View Translation Comparison →

Comet Phase 5: Archive

Prerequisites

Verification passed (Phase 4 completed)
Branch has been processed

verify_result: pass

is set in

openspec/changes/<name>/.comet.yaml

Steps

0. Entry Status Check

Perform entry verification:

bash

COMET_SEARCH_ROOTS=("." "$HOME/.claude/skills" "$HOME/.codex/skills" "$HOME/.cursor/skills")
COMET_STATE="${COMET_STATE:-$(find "${COMET_SEARCH_ROOTS[@]}" -path '*/comet/scripts/comet-state.sh' -type f -print -quit 2>/dev/null)}"
bash "$COMET_STATE" check <name> archive

Proceed to Step 1 after verification passes. If verification fails, the script will output the specific failure reason.

1. Execute Archiving

Run the archive script to automatically complete all the following steps:

bash

bash "$COMET_ARCHIVE" "<change-name>"

The script automatically executes:

Entry status check (phase=archive, verify_result=pass, archived=false)
Sync delta spec to main spec
Prepend metadata to Design doc (archived-with, status)
Prepend metadata to Plan (archived-with)
Move the change to the archive directory

Update

archived: true

via

comet-state transition <archive-name> archived

If the script returns a non-zero exit code, report the error and stop. If the script returns a zero exit code, archiving is completed. The

X/Y steps succeeded

in the script summary counts the actual executed steps and will not accumulate repeatedly due to delta spec sync or document annotation.

When the delta spec to be synchronized is inconsistent with the existing main spec, the script will print a unified diff preview before overwriting to help confirm the archive synchronization content.

Use the

--dry-run

parameter to preview without actual execution.

2. Lifecycle Closure

The Spec lifecycle is completed here:

brainstorming → delta spec → implementation → verification → main spec overwrite → design doc annotation → archiving

Exit Criteria

Archive script executes successfully (exit code 0)

Archive directory

openspec/changes/archive/YYYY-MM-DD-<change-name>/

exists

```
archived: true
```
is set in the archived
```
.comet.yaml
```

The archive script will move

openspec/changes/<name>/

to

openspec/changes/archive/YYYY-MM-DD-<name>/

. After successful archiving, do not run

bash "$COMET_GUARD" <change-name> archive

for the original change name anymore, as the original active directory no longer exists. Archive integrity is determined by the script exit code and archive directory status.

Completion

The entire Comet process is completed. To start new work, invoke

/comet

or

/comet-open

.