sdd-spec

Generate structured delta specifications with RFC 2119 requirements and GIVEN/WHEN/THEN scenarios.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill sdd-spec-luisalbertomk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec
Source: https://github.com/LuisAlbertoMK/gentleman-agent-gh/tree/main/internal/assets/skills/sdd-spec
Command: npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill sdd-spec-luisalbertomk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of maintaining consistent, versioned technical specifications during iterative development by automating the creation of delta specs that track system changes.

Core Features & Use Cases

  • Delta Specification Generation: Automatically generates structured requirements and scenarios for added, modified, or removed capabilities.
  • Standardized Workflow: Enforces RFC 2119 compliance and GIVEN/WHEN/THEN scenario formatting for testable requirements.
  • Use Case: When a developer proposes a new feature, this skill generates the necessary delta specifications to ensure the implementation remains aligned with the project's architectural requirements.

Quick Start

Use the sdd-spec skill to generate delta specifications for the current proposal in the engram store.

Frequently Asked Questions about sdd-spec

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

FAQPage Schema
How do I generate delta specifications for iterative software development?

Delta specifications are generated by automating the creation of structured requirements and scenarios tracking system additions, modifications, and removals. This ensures implementation remains aligned with project architecture during iterative development.

What is a delta specification in an SDD workflow?

A delta specification in an SDD workflow is a versioned architectural artifact defining requirements and testable scenarios for system changes. It maintains consistent technical documentation throughout iterative software development.

How do I format requirements to be RFC 2119 compliant and testable?

Requirements are formatted to be RFC 2119 compliant and testable by enforcing standardized GIVEN/WHEN/THEN scenario formatting within generated delta specs. This structure ensures precise requirement language and verifiable testing scenarios.

Can I use delta specs for removing existing capabilities from a system?

Yes, delta specs can be generated for removed capabilities alongside additions and modifications. The structured specifications document architectural requirements and scenarios necessary to safely execute system removals.

Do I need an engram store to generate structured architectural requirements?

An engram store is used to generate delta specifications for the current proposal within the SDD workflow. It provides the contextual project data required to accurately structure versioned architectural artifacts.