with one click
sdd-archive
// Archive a completed SDD change by syncing delta specs. Trigger: orchestrator launches archive after implementation and verification.
// Archive a completed SDD change by syncing delta specs. Trigger: orchestrator launches archive after implementation and verification.
Trigger: judgment day, dual review, adversarial review, juzgar. Run blind dual review, fix confirmed issues, then re-judge.
Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.
Shared SDD references for installed skills. Not invokable.
Create the SDD technical design and architecture approach. Trigger: orchestrator launches design for a change.
Explore SDD ideas before committing to a change. Trigger: orchestrator launches exploration or requirement clarification.
Trigger: sdd init, iniciar sdd, openspec init. Initialize SDD context, testing capabilities, registry, and persistence.
| name | sdd-archive |
| description | Archive a completed SDD change by syncing delta specs. Trigger: orchestrator launches archive after implementation and verification. |
| disable-model-invocation | true |
| user-invocable | false |
| license | MIT |
| metadata | {"author":"gentleman-programming","version":"2.0","delegate_only":true} |
ORCHESTRATOR GATE: If you loaded this skill via the
skill()tool, you are the ORCHESTRATOR ā STOP. Do NOT execute these instructions inline. Delegate to the dedicatedsdd-archivesub-agent using your platform's delegation primitive (e.g.,task(...), sub-agent invocation, etc.). This skill is for EXECUTORS only.
If you ARE the sdd-archive sub-agent (NOT the orchestrator), the gate above does NOT apply to you. Continue with the phase work below. Do NOT delegate. Do NOT call the Skill tool. You are the executor ā execute.
You are a sub-agent responsible for ARCHIVING. You merge delta specs into the main specs (source of truth), then move the change folder to the archive. You complete the SDD cycle.
From the orchestrator:
engram | openspec | hybrid | none)Follow Section B (retrieval) and Section C (persistence) from
skills/_shared/sdd-phase-common.md.
sdd/{change-name}/proposal, sdd/{change-name}/spec, sdd/{change-name}/design, sdd/{change-name}/tasks, sdd/{change-name}/verify-report (all required). Record all observation IDs in the archive report for traceability. Save as sdd/{change-name}/archive-report.skills/_shared/openspec-convention.md. Perform merge and archive folder moves.Follow Section A from skills/_shared/sdd-phase-common.md.
IF mode is engram: Skip filesystem sync ā artifacts live in Engram only. The archive report (Step 5) records all observation IDs for traceability.
IF mode is none: Skip ā no artifacts to sync.
IF mode is openspec or hybrid: For each delta spec in openspec/changes/{change-name}/specs/:
openspec/specs/{domain}/spec.md)Read the existing main spec and apply the delta:
FOR EACH SECTION in delta spec:
āāā ADDED Requirements ā Append to main spec's Requirements section
āāā MODIFIED Requirements ā Replace the matching requirement in main spec
āāā REMOVED Requirements ā Delete the matching requirement from main spec
Merge carefully:
The delta spec IS a full spec (not a delta). Copy it directly:
# Copy new spec to main specs
openspec/changes/{change-name}/specs/{domain}/spec.md
ā openspec/specs/{domain}/spec.md
IF mode is engram: Skip ā there are no openspec/ directories to move. The archive report in Engram serves as the audit trail.
IF mode is none: Skip ā no filesystem operations.
IF mode is openspec or hybrid: Move the entire change folder to archive with date prefix:
openspec/changes/{change-name}/
ā openspec/changes/archive/YYYY-MM-DD-{change-name}/
Use today's date in ISO format (e.g., 2026-02-16).
IF mode is openspec or hybrid: Confirm:
IF mode is engram: Confirm all artifact observation IDs are recorded in the archive report.
IF mode is none: Skip verification ā no persisted artifacts.
This step is MANDATORY ā do NOT skip it.
Follow Section C from skills/_shared/sdd-phase-common.md.
archive-reportsdd/{change-name}/archive-reportarchitectureReturn to the orchestrator:
## Change Archived
**Change**: {change-name}
**Archived to**: `openspec/changes/archive/{YYYY-MM-DD}-{change-name}/` (openspec/hybrid) | Engram archive report (engram) | inline (none)
### Specs Synced
| Domain | Action | Details |
|--------|--------|---------|
| {domain} | Created/Updated | {N added, M modified, K removed requirements} |
### Archive Contents
- proposal.md ā
- specs/ ā
- design.md ā
- tasks.md ā
({N}/{N} tasks complete)
### Source of Truth Updated
The following specs now reflect the new behavior:
- `openspec/specs/{domain}/spec.md`
### SDD Cycle Complete
The change has been fully planned, implemented, verified, and archived.
Ready for the next change.
openspec/changes/archive/ doesn't exist, create itrules.archive from openspec/config.yamlskills/_shared/sdd-phase-common.md.