Spec-Driven Development (SDD) - Revision history

Mberne: /* Limitaciones */

2026-05-26T11:48:45Z

Limitaciones

← Older revision		Revision as of 13:48, 26 May 2026
Line 169:		Line 169:
	SDD tiene limitaciones que conviene conocer antes de adoptarlo:		SDD tiene limitaciones que conviene conocer antes de adoptarlo:

	'''Escribir buenas specs es difícil.''' Requiere claridad de pensamiento, conocimiento		* '''Escribir buenas specs es difícil.''' Requiere claridad de pensamiento, conocimiento del dominio y la disciplina de pensar antes de actuar. En proyectos donde los requisitos raramente están completamente formulados antes de la implementación, la spec puede convertirse en un artefacto aspiracional más que operativo.
	del dominio y la disciplina de pensar antes de actuar. En proyectos donde los		* '''El overhead puede ser desproporcionado en tareas pequeñas.''' Para funcionalidades simples o correcciones de bugs menores, el proceso de especificación puede generar más trabajo del que ahorra. SDD tiene más sentido cuando la complejidad de la funcionalidad justifica la inversión previa.
	requisitos raramente están completamente formulados antes de la implementación,		* '''Las specs no eliminan el no-determinismo de los modelos.''' Una especificación detallada reduce la libertad no deseada del agente, pero no la elimina. Los modelos de lenguaje pueden ignorar instrucciones, excederse en su interpretación o generar outputs que cumplen la spec literalmente pero no en espíritu. La [[Revisión humana de outputs de IA\|revisión humana]] sigue siendo necesaria.
	la spec puede convertirse en un artefacto aspiracional más que operativo.

	'''El overhead puede ser desproporcionado en tareas pequeñas.''' Para funcionalidades
	simples o correcciones de bugs menores, el proceso de especificación puede generar
	más trabajo del que ahorra. SDD tiene más sentido cuando la complejidad de la
	funcionalidad justifica la inversión previa.

	'''Las specs no eliminan el no-determinismo de los modelos.''' Una especificación
	detallada reduce la libertad no deseada del agente, pero no la elimina. Los modelos
	de lenguaje pueden ignorar instrucciones, excederse en su interpretación o generar
	outputs que cumplen la spec literalmente pero no en espíritu. La
	[[Revisión humana de outputs de IA\|revisión humana]] sigue siendo necesaria.

	== Error frecuente ==		== Error frecuente ==

Mberne: /* SDD y la IA */

2026-05-26T11:48:14Z

SDD y la IA

← Older revision		Revision as of 13:48, 26 May 2026
Line 164:		Line 164:

	En este sentido, SDD transforma el papel del desarrollador. El valor no desaparece: cambia de lugar. Gana peso la capacidad de escribir specs, diseñar arquitectura, revisar críticamente outputs de IA y decidir qué debe automatizarse y qué debe permanecer bajo control humano.		En este sentido, SDD transforma el papel del desarrollador. El valor no desaparece: cambia de lugar. Gana peso la capacidad de escribir specs, diseñar arquitectura, revisar críticamente outputs de IA y decidir qué debe automatizarse y qué debe permanecer bajo control humano.

			== Limitaciones ==

			SDD tiene limitaciones que conviene conocer antes de adoptarlo:

			'''Escribir buenas specs es difícil.''' Requiere claridad de pensamiento, conocimiento
			del dominio y la disciplina de pensar antes de actuar. En proyectos donde los
			requisitos raramente están completamente formulados antes de la implementación,
			la spec puede convertirse en un artefacto aspiracional más que operativo.

			'''El overhead puede ser desproporcionado en tareas pequeñas.''' Para funcionalidades
			simples o correcciones de bugs menores, el proceso de especificación puede generar
			más trabajo del que ahorra. SDD tiene más sentido cuando la complejidad de la
			funcionalidad justifica la inversión previa.

			'''Las specs no eliminan el no-determinismo de los modelos.''' Una especificación
			detallada reduce la libertad no deseada del agente, pero no la elimina. Los modelos
			de lenguaje pueden ignorar instrucciones, excederse en su interpretación o generar
			outputs que cumplen la spec literalmente pero no en espíritu. La
			[[Revisión humana de outputs de IA\|revisión humana]] sigue siendo necesaria.

	== Error frecuente ==		== Error frecuente ==

Mberne: /* Relación con TDD y BDD */

2026-05-26T11:47:35Z

Relación con TDD y BDD

← Older revision		Revision as of 13:47, 26 May 2026
Line 115:		Line 115:
	\|}		\|}

	En la práctica, un equipo puede usar SDD para definir una funcionalidad completa, TDD para cada tarea de implementación individual y BDD para las validaciones de		En la práctica un equipo puede usar:
	extremo a extremo. SDD actúa como capa de contexto compartido que mantiene alineados a humanos y agentes durante todo el proceso.		* SDD para definir una funcionalidad completa,
			* TDD para cada tarea de implementación individual
			* y BDD para las validaciones de extremo a extremo.

			SDD actúa como capa de contexto compartido que mantiene alineados a humanos y agentes durante todo el proceso.

	== SDD en equipos Scrum con IA ==		== SDD en equipos Scrum con IA ==

Mberne: /* Relación con las historias de usuario */

2026-05-26T11:46:51Z

Relación con las historias de usuario

← Older revision		Revision as of 13:46, 26 May 2026
Line 98:		Line 98:

	En equipos con IA, una historia puede seguir siendo el punto de partida del backlog, pero las tareas que vaya a ejecutar un agente necesitan una spec suficientemente clara.		En equipos con IA, una historia puede seguir siendo el punto de partida del backlog, pero las tareas que vaya a ejecutar un agente necesitan una spec suficientemente clara.

			== Relación con TDD y BDD ==

			SDD no compite con [[TDD\|TDD]] ni con [[Behavior-Driven Development\|BDD]].
			Los tres enfoques son complementarios y pueden aplicarse juntos:

			{\| class="wikitable"
			\|-
			! Práctica !! Foco !! Pregunta que responde
			\|-
			\| '''SDD''' \|\| Especificación. Define el qué y el por qué antes de implementar. \|\| ¿Qué debe construirse exactamente y bajo qué restricciones?
			\|-
			\| '''TDD''' \|\| Calidad a nivel de unidad. El test precede al código. \|\| ¿Esta unidad de código hace lo que debe hacer?
			\|-
			\| '''BDD''' \|\| Comportamiento del sistema. Escenarios en formato Given-When-Then. \|\| ¿El sistema se comporta como esperan los usuarios y stakeholders?
			\|}

			En la práctica, un equipo puede usar SDD para definir una funcionalidad completa, TDD para cada tarea de implementación individual y BDD para las validaciones de
			extremo a extremo. SDD actúa como capa de contexto compartido que mantiene alineados a humanos y agentes durante todo el proceso.

	== SDD en equipos Scrum con IA ==		== SDD en equipos Scrum con IA ==

Mberne: /* Herramientas del ecosistema */

2026-05-26T11:46:22Z

Herramientas del ecosistema

@@ Line 59: / Line 59: @@
 == Herramientas del ecosistema ==
 El ecosistema de herramientas orientadas a SDD está creciendo rápidamente. Las principales opciones disponibles en 2025-2026:
 Ninguna de estas herramientas es imprescindible para aplicar SDD. El enfoque puede implementarse con cualquier agente de código si el equipo escribe la spec en un formato estructurado antes de delegar la implementación.

Mberne: /* Herramientas del ecosistema */

2026-05-26T11:11:17Z

Herramientas del ecosistema

← Older revision		Revision as of 13:11, 26 May 2026
Line 59:		Line 59:
	== Herramientas del ecosistema ==		== Herramientas del ecosistema ==
	El ecosistema de herramientas orientadas a SDD está creciendo rápidamente. Las principales opciones disponibles en 2025-2026:		El ecosistema de herramientas orientadas a SDD está creciendo rápidamente. Las principales opciones disponibles en 2025-2026:

			Ninguna de estas herramientas es imprescindible para aplicar SDD. El enfoque puede implementarse con cualquier agente de código si el equipo escribe la spec en un formato estructurado antes de delegar la implementación.

	== Relación con las historias de usuario ==		== Relación con las historias de usuario ==

Mberne: /* Niveles de adopción */

2026-05-26T11:08:05Z

Niveles de adopción

← Older revision		Revision as of 13:08, 26 May 2026
Line 56:		Line 56:

	La mayoría de equipos empiezan por un enfoque ''spec-first''. Pretender saltar directamente a ''spec-as-source'' puede generar más rigidez que valor si el equipo no tiene prácticas sólidas de validación, testing y revisión.		La mayoría de equipos empiezan por un enfoque ''spec-first''. Pretender saltar directamente a ''spec-as-source'' puede generar más rigidez que valor si el equipo no tiene prácticas sólidas de validación, testing y revisión.

			== Herramientas del ecosistema ==
			El ecosistema de herramientas orientadas a SDD está creciendo rápidamente. Las principales opciones disponibles en 2025-2026:

	== Relación con las historias de usuario ==		== Relación con las historias de usuario ==

Mberne: /* Véase también */

2026-05-20T09:41:56Z

Véase también

← Older revision		Revision as of 11:41, 20 May 2026
Line 152:		Line 152:

	<div class="bok-tags">		<div class="bok-tags">
	~~[[Spec]] [[Spec writing]]~~ [[Vibe coding]] [[Vibe engineering]] [[Agente de IA]] [[Prompt engineering]] [[Historia de usuario]] [[~~Definition of Done~~]]		[[Vibe coding]] [[Vibe engineering]] [[Agente de IA]] [[Prompt engineering]] [[Historia de usuario]] [[Definición de hecho]]
	</div>		</div>

Mberne: /* Recursos */

2026-05-20T09:41:35Z

Recursos

← Older revision		Revision as of 11:41, 20 May 2026
Line 136:		Line 136:
	<div class="bok-recurso">		<div class="bok-recurso">
	🏦 [https://scrummanager.com/skillarena/sdd-en-equipos-agiles '''SDD en equipos ágiles''']<span class="detalle">Skill Arena · Scrum Manager</span>		🏦 [https://scrummanager.com/skillarena/sdd-en-equipos-agiles '''SDD en equipos ágiles''']<span class="detalle">Skill Arena · Scrum Manager</span>
	~~</div>~~
	~~<div class="bok-recurso">~~
	📄 [https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html '''Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl''']<span class="detalle">Artículo de Birgitta Böckeler sobre definición y niveles de SDD · Martin Fowler · 2025</span>
	~~</div>~~
	~~<div class="bok-recurso">~~
	📄 [https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/ '''Spec-driven development with AI: Get started with a new open source toolkit''']<span class="detalle">Artículo sobre Spec Kit y flujos de SDD con agentes de código · GitHub Blog · 2025</span>
	~~</div>~~
	~~<div class="bok-recurso">~~
	~~📊 [https://github.com/github/spec-kit '''Spec Kit''']<span class="detalle">Toolkit open source para flujos de desarrollo dirigidos por especificación · GitHub</span>~~
	</div>		</div>

Mberne: /* Recursos */

2026-05-19T15:26:21Z

Recursos

← Older revision		Revision as of 17:26, 19 May 2026
Line 131:		Line 131:

	== Recursos ==		== Recursos ==

	<div class="bok-recurso">		<div class="bok-recurso">
	📄 [https://~~martinfowler~~.com/~~articles~~/~~exploring-gen-ai~~/~~sdd-3-tools~~.~~html Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl~~]<span class="detalle">~~Artículo de Birgitta Böckeler sobre definición y niveles de SDD · Martin Fowler~~ · ~~2025~~</span>		📊 [https://scrummanager.com/website/c/info/resource.php?id=374 '''Guía didáctica SDD''']<span class="detalle">Recursos · Scrum Manager</span>
	</div>		</div>

	<div class="bok-recurso">		<div class="bok-recurso">
	📄 [https://~~github~~.~~blog~~/~~ai-and-ml~~/~~generative~~-~~ai/spec~~-~~driven~~-~~development-with-ai-get-started-with-a-new-open-source-toolkit/ Spec-driven development with AI: Get started with a new open source toolkit~~]<span class="detalle">~~Artículo sobre Spec Kit y flujos de SDD con agentes de código · GitHub Blog~~ · ~~2025~~</span>		🏦 [https://scrummanager.com/skillarena/sdd-en-equipos-agiles '''SDD en equipos ágiles''']<span class="detalle">Skill Arena · Scrum Manager</span>
	</div>		</div>

	<div class="bok-recurso">		<div class="bok-recurso">
	📊 [https://github.com/github/spec-kit Spec Kit]<span class="detalle">Toolkit open source para flujos de desarrollo dirigidos por especificación · GitHub</span>		📄 [https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html '''Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl''']<span class="detalle">Artículo de Birgitta Böckeler sobre definición y niveles de SDD · Martin Fowler · 2025</span>
			</div>
			<div class="bok-recurso">
			📄 [https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/ '''Spec-driven development with AI: Get started with a new open source toolkit''']<span class="detalle">Artículo sobre Spec Kit y flujos de SDD con agentes de código · GitHub Blog · 2025</span>
			</div>
			<div class="bok-recurso">
			📊 [https://github.com/github/spec-kit '''Spec Kit''']<span class="detalle">Toolkit open source para flujos de desarrollo dirigidos por especificación · GitHub</span>
	</div>		</div>