2.1 KiB
2.1 KiB
description
| description |
|---|
| Archive a deployed OpenSpec change and update specs. |
The user wants to archive the following deployed change. Use the openspec instructions to archive the change and update specs.
$ARGUMENTS **Guardrails** - Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required. - Keep changes tightly scoped to the requested outcome. - Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.Steps
- Determine the change ID to archive:
- If this prompt already includes a specific change ID (for example inside a
<ChangeId>block populated by slash-command arguments), use that value after trimming whitespace. - If the conversation references a change loosely (for example by title or summary), run
openspec listto surface likely IDs, share the relevant candidates, and confirm which one the user intends. - Otherwise, review the conversation, run
openspec list, and ask the user which change to archive; wait for a confirmed change ID before proceeding. - If you still cannot identify a single change ID, stop and tell the user you cannot archive anything yet.
- If this prompt already includes a specific change ID (for example inside a
- Validate the change ID by running
openspec list(oropenspec show <id>) and stop if the change is missing, already archived, or otherwise not ready to archive. - Run
openspec archive <id> --yesso the CLI moves the change and applies spec updates without prompts (use--skip-specsonly for tooling-only work). - Review the command output to confirm the target specs were updated and the change landed in
changes/archive/. - Validate with
openspec validate --strictand inspect withopenspec show <id>if anything looks off.
Reference
- Use
openspec listto confirm change IDs before archiving. - Inspect refreshed specs with
openspec list --specsand address any validation issues before handing off.