sdd-spec

Generate structured delta specifications for added, modified, or removed software behavior.

Updated Mar 26, 2025
One-click install
npx skills add https://github.com/ricardoalt1515/.config --skill sdd-spec-ricardoalt1515
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec
Source: https://github.com/ricardoalt1515/.config/tree/main/opencode/skills/sdd-spec
Command: npx skills add https://github.com/ricardoalt1515/.config --skill sdd-spec-ricardoalt1515

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of writing delta specifications, providing structured requirements and scenarios for software changes.

Core Features & Use Cases

  • Delta Specification Generation: Automatically generate specifications for added, modified, or removed behavior in a system.
  • Language Domain Contract: Ensures technical artifacts are written in English by default, with options for Spanish.
  • Execution and Persistence Contract: Defines the steps for reading existing specs, writing new ones, and persisting artifacts.
  • MODIFIED Requirements Workflow: Includes a detailed workflow for modifying existing requirements, ensuring all scenarios are preserved.

Quick Start

Use the sdd-spec skill to generate a delta specification for a change named 'update-system'.

Frequently Asked Questions about sdd-spec

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

FAQPage Schema
What is a delta specification in software development?

A delta specification documents only the added, modified, or removed behavior in a system rather than rewriting the entire spec. This Skill automates generating those structured requirements and scenarios for targeted software changes.

How do I generate structured requirements for a software change?

To generate structured requirements, delegate execution to the sdd-spec sub-agent. You provide a change proposal and existing specifications, and the Skill reads them to produce new structured scenarios and persisted artifacts.

How are modified requirements handled when updating an existing specification?

Modified requirements follow a dedicated workflow that reads the existing specification and preserves all current scenarios. The Skill ensures no original scenarios are lost while injecting the new delta changes into the artifact store.

Can I write software specifications in Spanish instead of English?

Yes, technical artifacts are written in English by default, but the Language Domain Contract includes options for Spanish. You can configure the Skill to generate the delta specification artifacts in Spanish.

What inputs do I need before automating a delta specification?

You need an existing specification and a defined change proposal before automating the delta specification. The Skill requires access to both to read current behavior and generate accurate structured scenarios for the update.

Does the delta specification process support multiple artifact stores?

Yes, the execution and persistence contract supports multiple artifact stores. This allows the generated delta specifications and structured requirements to be saved across different storage locations as needed.