sdd-archive

Merge delta specs into main specifications and archive change folders.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/sebasmzg/sebas.dot --skill sdd-archive-sebasmzg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-archive
Source: https://github.com/sebasmzg/sebas.dot/tree/main/.config/opencode/skills/sdd-archive
Command: npx skills add https://github.com/sebasmzg/sebas.dot --skill sdd-archive-sebasmzg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the finalization and archival of software design documentation changes by merging delta specifications into the canonical specs and creating an auditable archive after verification, removing manual merging and traceability overhead.

Core Features & Use Cases

  • Engram persistence: Locate artifacts via mem_search, retrieve full content with mem_get_observation, and persist an archive report with mem_save that records observation IDs for traceability.
  • Openspec filesystem merge: Apply delta changes to openspec/specs by adding, modifying, or removing requirements while preserving unrelated content and proper markdown structure, and move change folders into dated archives.
  • Hybrid and none modes: Support engram-only, openspec-only, hybrid (both), and none (dry-run/summary) modes with verification gating and safeguards against destructive merges.

Quick Start

Archive the change named feature-x by merging its delta specs into main specs, recording all observation IDs, and moving the change folder to openspec/changes/archive/YYYY-MM-DD-feature-x according to the project mode.

Frequently Asked Questions about sdd-archive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge delta specs into main specifications after implementation?

To merge delta specs into main specifications, apply openspec filesystem operations that add, modify, or remove requirements while preserving existing markdown structure, then move the change folder into a dated archive directory.

What is the best way to archive implemented software design documentation changes?

Archiving software design documentation changes requires merging delta specifications into canonical specs and creating an auditable archive after verification, supporting engram-only, openspec-only, hybrid, or none modes for finalization.

How does Engram mem_search and mem_save support spec archival and traceability?

Engram supports spec archival traceability by using mem_search to locate artifacts, mem_get_observation to retrieve full content, and mem_save to persist an archive report that records mandatory observation IDs for full verification traceability.

Can I run a dry-run summary without applying destructive merges to openspec files?

Yes, the none mode provides a dry-run summary without applying destructive merges. The archival workflow includes safeguards against destructive changes, ensuring openspec filesystem merges only proceed after verification gating is explicitly satisfied.

When should I not use automated spec merging for software design documentation?

Automated spec merging should not proceed when verification gating is incomplete or unrelated markdown content cannot be safely preserved. The archival workflow enforces mandatory observation ID recording to prevent untraceable destructive spec modifications.

Do I need openspec and Engram environments configured to archive SDD changes?

You need openspec filesystem support for delta merges and archive moves, plus Engram mem_search, mem_get_observation, and mem_save flows to record observation IDs. The workflow operates in engram-only, openspec-only, hybrid, or none modes depending on available infrastructure.