sdd-archive

Merge delta specifications into main specs and archive completed SDD changes.

2|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/kurojs/EnderDots --skill sdd-archive-kurojs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-archive
Source: https://github.com/kurojs/EnderDots/tree/main/.config/opencode/skills/sdd-archive
Command: npx skills add https://github.com/kurojs/EnderDots --skill sdd-archive-kurojs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves the risk of losing change history by merging finalized delta specifications into the main “source of truth” and then archiving the full completed change for traceability.

Core Features & Use Cases

  • Delta-to-main spec synchronization: Merges added, modified, and removed requirements from delta specs into existing main specs while preserving unspecified requirements.
  • Archive folder movement with ISO dates: Moves the entire change folder into an archive location using a YYYY-MM-DD prefix to maintain an immutable audit trail.
  • Mode-aware persistence and reporting: Supports engram, openspec, hybrid, and none artifact modes, including mandatory archive-report persistence keyed by change name.
  • Verification guardrails: Encourages verification of main spec updates, archive contents, and active directory cleanup, with rules to avoid archiving on critical verification issues.

Quick Start

Run the sdd-archive skill as the executor after implementation and verification, providing the change name and artifact store mode so it can sync specs, archive the change, and persist the archive-report.

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 specifications into main specs for an audit trail?

To merge delta specifications into main specs for an audit trail, you merge added, modified, and removed requirements from delta files into existing main specs while preserving unspecified requirements. This ensures your finalized changes are synchronized into the source of truth.

What is the best way to archive completed SDD changes with ISO date prefixes?

The best way to archive completed SDD changes with ISO date prefixes is to relocate the entire finalized change folder into an archive location using a YYYY-MM-DD prefix. This creates an immutable audit trail that ensures long-term traceability of your modifications.

Does sdd-archive work with openspec, engram, hybrid, and none artifact modes?

Yes, sdd-archive works with openspec, engram, hybrid, and none artifact modes. It applies to executor-phase workflows in these modes by driving requirement updates from delta spec files and mandating archive-report persistence keyed by the change name.

Can I archive a change folder if critical verification issues exist?

No, you cannot archive a change folder if critical verification issues exist. The process includes verification guardrails that encourage checking main spec updates, archive contents, and active directory cleanup, with strict rules to avoid archiving when critical issues are detected.

How do I persist an archive-report keyed by change name after spec synchronization?

To persist an archive-report keyed by change name after spec synchronization, you save it using the architecture topic keyed by sdd/{change-name}/archive-report. This mode-aware persistence step guarantees the archived change remains traceable within your workflow.