betterspec archive

Archive a completed change, optionally generating an outcome summary and extracting any capabilities discovered during the work.

Usage

betterspec archive <change>

The <change> argument is the name of the change directory under betterspec/changes/active/.

Options

Behavior

1. If outcome.md does not exist in the change directory and --skip-outcome is not set, you will be prompted to write one.
2. Capabilities referenced in the change are extracted and registered.
3. The change directory is moved from betterspec/changes/active/ to betterspec/changes/archive/ with a date prefix (e.g. 2026-03-12-my-change).

Examples

Archive a change, prompting for outcome if missing:

$ betterspec archive add-search
? No outcome.md found. Write one now? (Y/n) Y
# opens $EDITOR for outcome.md

Extracted 2 capabilities from add-search
Archived: betterspec/changes/archive/2026-03-12-add-search

Skip the outcome prompt:

$ betterspec archive add-search --skip-outcome
Archived: betterspec/changes/archive/2026-03-12-add-search