sdd-spec

Generate a formal SDD specification with Goals, Non-Goals, and testable Acceptance Criteria.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/juanmanueldaza/invencible --skill sdd-spec-juanmanueldaza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec
Source: https://github.com/juanmanueldaza/invencible/tree/main/.claude/skills/sdd-spec
Command: npx skills add https://github.com/juanmanueldaza/invencible --skill sdd-spec-juanmanueldaza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates a formal Software Design Description (SDD) specification from a planned change proposal, reducing ambiguity during reviews and implementation.

Core Features & Use Cases

  • Produces a structured SDD with sections: Goals, Non-Goals, Acceptance Criteria, Constraints, and Out of Scope.
  • Integrates with memory: loads the proposal and relevant context from memory, then saves the spec back with a consistent topic key.
  • Use Case: After drafting a change proposal, run this skill to produce a testable specification that reviewers can verify against implementation.

Quick Start

Load the proposal from memory and write the complete SDD specification.

Frequently Asked Questions about sdd-spec

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

FAQPage Schema
How do I generate a formal specification document from a change proposal?

You can generate a formal specification document by loading a planned change proposal from memory and running this skill to output a structured SDD with Goals, Non-Goals, Acceptance Criteria, Constraints, and Out of Scope sections.

What is the best way to define testable acceptance criteria for software reviews?

The best way to define testable acceptance criteria is to produce a formal SDD specification that enforces every criterion to be testable, reducing ambiguity during implementation and verification against the planned change.

How does memory integration work when creating an SDD specification?

Memory integration for SDD specifications works by loading the proposal and relevant context using a topic key, then saving the generated structured spec back into memory with consistent fields like title, topic_key, type, and content blocks.

What sections should be included in a software design description to reduce ambiguity?

A software design description that reduces ambiguity should include structured sections for Goals, Non-Goals, Acceptance Criteria, Constraints, and Out of Scope, ensuring reviewers can verify implementation against testable requirements.

Do I need a change proposal before writing an SDD specification?

Yes, you need a planned change proposal before writing an SDD specification, because this skill operates after an sdd-propose step to read the proposal and context from memory to produce the formal structured document.

Why specify non-goals and out of scope sections in software specifications?

Specifying non-goals and out of scope sections in software specifications prevents scope creep and reduces ambiguity during reviews by clearly defining what the planned change will not address, ensuring reviewers focus only on testable goals.