sdd-spec

Generate delta specifications detailing added, modified, and removed requirements with scenarios.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fwdarth/agent-teams-lite-domainaware --skill sdd-spec-fwdarth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec
Source: https://github.com/fwdarth/agent-teams-lite-domainaware/tree/main/.opencode/skills/sdd-spec
Command: npx skills add https://github.com/fwdarth/agent-teams-lite-domainaware --skill sdd-spec-fwdarth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of documenting changes to software by generating structured specifications that clearly outline additions, modifications, and removals.

Core Features & Use Cases

  • Delta Specification Generation: Creates detailed delta specs for new or modified requirements.
  • Scenario Definition: Includes both happy path and edge case scenarios for each requirement.
  • Use Case: When a new feature is proposed, this Skill can be used to generate the precise requirements and testable scenarios that developers and testers will follow.

Quick Start

Use the sdd-spec skill to write delta specifications for the change named 'user-authentication-update'.

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 specific additions, modifications, and removals of requirements for a software change. It provides clear, version-controlled documentation of behavioral changes to maintain alignment across the software development lifecycle.

How do I document software requirements using Given When Then scenarios?

You document software requirements by defining both happy path and edge case scenarios for each requirement using Given/When/Then formatting. This structure ensures requirements are clear and testable for developers and testers.

How do I write a delta spec for a new feature?

To write a delta spec for a new feature, generate structured specifications detailing the added, modified, and removed requirements. Include corresponding testable scenarios and apply RFC 2119 keywords to indicate requirement levels precisely.

When do I need to use RFC 2119 keywords for software specifications?

You need to use RFC 2119 keywords when writing delta specifications to clearly define the obligation levels of requirements, such as MUST or SHOULD. This ensures behavioral changes are documented with unambiguous clarity for implementation.

Does this approach support version-controlled documentation of behavioral changes?

Yes, generating delta specifications supports version-controlled documentation by explicitly detailing added, modified, and removed requirements. This structured approach tracks behavioral changes clearly across software development lifecycles.

What is the best way to outline modified and removed requirements for a software update?

The best way to outline modified and removed requirements is generating a delta specification that structures these changes alongside their corresponding scenarios. Applying Given/When/Then formatting ensures the documented behavioral changes remain testable.