| name | sdd-archive |
| description | Merge completed deltas into main specs and archive the change. |
SDD Archive Skill
Close the SDD loop by promoting verified change specs into main specs and
recording an audit trail.
Shared Conventions
Persistence Mode
The orchestrator passes the artifact store mode (thoth-mem, openspec, or
hybrid). Follow the persistence contract for read/write rules per mode.
thoth-mem: persist to thoth-mem only — do NOT create or modify
openspec/ files.
openspec: write files only — do NOT call thoth-mem save tools.
hybrid: persist to both (default).
When to Use
- The change has an acceptable verification report and is ready to close
- An archive attempt must be retried after an interrupted move or merge
Prerequisites
change-name
pipeline-type (accelerated or full)
- Tasks artifact
- Verify report artifact
- Spec artifact (full pipeline only)
- Design artifact (full pipeline only)
- Proposal artifact (always — used for audit trail)
Workflow
-
Read the shared conventions.
-
Recover artifacts through the retrieval protocol in
the persistence contract:
- Always: recover
proposal, tasks, and verify-report
- Full pipeline only: recover
spec and design
-
Refuse to archive if the verification report still contains unresolved
critical failures.
-
If the selected mode includes OpenSpec and the pipeline is full, merge
every change spec from
openspec/changes/{change-name}/specs/{domain}/spec.md into
openspec/specs/{domain}/spec.md. In accelerated pipeline, skip the
spec merge (no delta specs exist).
-
If the selected mode includes OpenSpec, move the completed change directory
to openspec/changes/archive/YYYY-MM-DD-{change-name}/.
-
Create an audit trail report summarizing merged domains, archive location,
verification lineage, and any mode-based skips.
-
Apply the governance-touched heuristic from
_shared/openspec-convention.md > Constitution Governance > Amendment
Auto-Suggest. When it matches, surface the shared report-only
sdd-constitution suggestion. This is advisory and MUST NOT block archival.
-
In thoth-mem mode, do not create or move openspec/ artifacts; record the
archive result only in the audit trail.
-
If the selected mode includes thoth-mem, persist the audit trail with:
Use the memory tool binding for mem_save with the canonical SDD topic key
and required metadata fields: title, topic_key, type, project,
scope, and content.
Output Format
Return:
Change
Archive Path: openspec/changes/archive/YYYY-MM-DD-{change-name}/
Topic Key: sdd/{change-name}/archive-report
Merged Specs: list of domains updated in openspec/specs/
Audit Summary: concise bullets
Constitution Suggestion: surfaced or none
Status: archived or blocked
Rules
- Archive only after verification is acceptable.
- In full pipeline, merge delta specs before moving the change folder.
In accelerated pipeline, skip the spec merge (no delta specs exist).
- Preserve canonical spec structure and untouched requirements.
- Persist the final audit trail through thoth-mem when the selected mode
includes it.
- Use the retrieval protocol in the persistence contract for every dependency.