This skill should be used when the user asks to "archive a change", "merge deltas", "finalize a spec", "complete a change", or wants to merge spec deltas into reference specs and archive the change.
specs/ is for specs only. No code files. deltas/ contains only spec.md files. All code goes elsewhere.[CLARIFICATION NEEDED] and resolve them before proceeding.Don't:
How to archive a completed change by merging deltas into reference specs.
If tasks.md exists, count incomplete tasks (- [ ]). Warn the user and confirm before proceeding if any remain.
For each directory in change-dir/deltas/:
specs/reference/<same-name>/spec.md (if it exists)Invoke the spec-sync agent with the change directory path and spec root. The agent handles all delta-to-reference merging (ADDED, MODIFIED, REMOVED, RENAMED) and creates new capability specs as needed. Run spexl template reference-spec for the reference spec template when creating new capabilities.
"Merge the spec deltas from {change-dir} into the reference specs. Spec root: {spec-root}"
Do not merge inline. The merge is mechanical work that belongs in a subagent to keep the main context clean.
Invoke spec-critic agent (inter-spec mode) on the updated reference specs. The merge is mechanical -- the critic checks that the result makes sense and doesn't contradict itself. If the critic returns needs-work or blocked, fix the reference specs before proceeding.
specs/changes/slug/ → specs/changes/archive/YYYY-MM-DD-slug/
Archive keeps the change history browsable without cluttering active specs.
Reference specs should describe how things work now, not how they changed. The archived change directory preserves the history.
For additional context during execution:
spexl context archive -- full phase-specific guidancespexl context rules -- core SDD rulesspexl context spec-notation -- notation for writing spec deltasspexl template <type> -- artifact templates (proposal, spec-delta, design, tasks)spexl new <slug> -- scaffold a new change directoryspexl validate -- check structural integrityspexl changes -- list active changesspexl info <slug> -- show change overview