# Sdd Spec

> Escribe especificaciones técnicas en formato Given/When/Then, describiendo qué debe hacer el sistema y no cómo, con escenarios de caso feliz, bordes y errores.

- Skill: `leandrobenjaminl/sdd-spec` (Agent Skill)
- Install (CLI): `npx skillmds@latest add leandrobenjaminl/sdd-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/leandrobenjaminl/sdd-spec/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, Testing & QA
- Tags: Gherkin, Given When Then, Specifications, Technical Writing
- License: MIT
- Author: LeandroBenjaminL (https://skillmd.com/u/leandrobenjaminl)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/leandrobenjaminl/sdd-spec

---


# Skill: sdd-spec

Especificaciones técnicas. Si podés escribir un test a partir de un escenario, el spec está bien.

## Trigger

- La propuesta está aprobada
- Necesitás detallar el comportamiento esperado
- Hay que actualizar specs existentes por un cambio

## Workflow LEND

1. ANALIZAR
   ├── Propuesta: ¿qué dijimos que íbamos a hacer?
   ├── Alcance: ¿qué entra y qué NO entra en esta spec?
   ├── Escenarios: caso feliz, casos borde, errores
   └── Dependencias: ¿esto afecta a otras specs?

2. OFRECER (Menú del Senior)
   ├── A) Specs en lenguaje natural — Given/When/Then en markdown, sin tecnicismos
   ├── B) Specs formales — Gherkin, con ejemplos concretos y tablas de decisión
   └── C) Specs + tests — escenarios + esqueleto de tests para cada uno

3. ELEGIR → confirmación

4. HACER
   ├── Formato: Given (contexto), When (acción), Then (resultado esperado)
   ├── Cubrir: caso feliz, casos borde, errores, performance si aplica
   ├── Especificar: QUÉ debe pasar, no CÓMO implementarlo
   ├── Ejemplos concretos: datos de entrada y salida esperada
   └── Contract: si hay API, especificar request/response

5. VERIFICAR
   ├── Cada escenario es testeable
   ├── No hay ambigüedad en los criterios
   └── Los specs describen comportamiento, no implementación