Spec: Difference between revisions

Jump to navigation Jump to search
Created page with "{{Meta-bok|min=5}} <div class="bok-def"> Una '''spec''' es una especificación operativa que define qué debe construirse, bajo qué restricciones y cómo se verificará el resultado. En Spec-Driven Development, la spec funciona como puente entre la intención humana y la ejecución por un agente de IA: convierte una necesidad, historia o hipótesis en instrucciones claras, revisables y testeables. </div> En desarrollo asistido por IA, una spec no..."
 
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Meta-bok|min=5}}
{{Meta-bok|min=5}}
 
Una '''spec''' es una especificación operativa que define qué debe construirse, bajo qué restricciones y cómo se verificará el resultado. En [[Spec-Driven Development (SDD)]], la spec funciona como puente entre la intención humana y la ejecución por un [[Agente de IA|agente de IA]]: convierte una necesidad, historia o hipótesis en instrucciones claras, revisables y testeables.
<div class="bok-def">
Una '''spec''' es una especificación operativa que define qué debe construirse, bajo qué restricciones y cómo se verificará el resultado. En [[Spec-Driven Development]], la spec funciona como puente entre la intención humana y la ejecución por un [[Agente de IA|agente de IA]]: convierte una necesidad, historia o hipótesis en instrucciones claras, revisables y testeables.
</div>


En desarrollo asistido por IA, una spec no es un documento decorativo ni una formalidad burocrática. Es el artefacto que permite que humanos y agentes compartan una misma interpretación del trabajo.
En desarrollo asistido por IA, una spec no es un documento decorativo ni una formalidad burocrática. Es el artefacto que permite que humanos y agentes compartan una misma interpretación del trabajo.
Line 203: Line 200:
== Spec y Spec-Driven Development ==
== Spec y Spec-Driven Development ==


En [[Spec-Driven Development]], la spec es el artefacto central. El equipo no salta directamente del deseo al código generado por IA. Primero define la especificación, la revisa y solo después la usa para guiar la implementación.
En [[Spec-Driven Development (SDD)]], la spec es el artefacto central. El equipo no salta directamente del deseo al código generado por IA. Primero define la especificación, la revisa y solo después la usa para guiar la implementación.


Esto cambia la relación con el agente de IA. En [[Vibe coding]], el agente funciona como interlocutor conversacional: se le pide, se prueba, se corrige y se vuelve a pedir. En SDD, el agente trabaja contra una spec: tiene un contrato de comportamiento, límites y verificación.
Esto cambia la relación con el agente de IA. En [[Vibe coding|vibe coding]], el agente funciona como interlocutor conversacional: se le pide, se prueba, se corrige y se vuelve a pedir. En SDD, el agente trabaja contra una spec: tiene un contrato de comportamiento, límites y verificación.


La spec convierte al agente en ejecutor controlado, no en decisor implícito.
La spec convierte al agente en ejecutor controlado, no en decisor implícito.
Line 262: Line 259:
En equipos con IA, una tarea no debería asignarse a un agente solo porque parece automatizable. Debe estar preparada.
En equipos con IA, una tarea no debería asignarse a un agente solo porque parece automatizable. Debe estar preparada.


Una [[Definition of Ready para IA]] puede exigir que:
Una Definition of Ready para IA puede exigir que:


* la spec esté completa y revisada;
* la spec esté completa y revisada;
Line 278: Line 275:
La spec también ayuda a comprobar si algo está terminado.
La spec también ayuda a comprobar si algo está terminado.


La [[Definition of Done|Definition of Done]] define criterios generales de calidad. La spec define criterios específicos de la funcionalidad o tarea. Ambas se complementan.
La [[Definición de hecho|Definition of Done]] define criterios generales de calidad. La spec define criterios específicos de la funcionalidad o tarea. Ambas se complementan.


Un cambio generado por IA no debería considerarse terminado solo porque el agente diga que ha cumplido. Debe verificarse contra:
Un cambio generado por IA no debería considerarse terminado solo porque el agente diga que ha cumplido. Debe verificarse contra:
Line 377: Line 374:


== Recursos ==
== Recursos ==
<div class="bok-recurso">
📄 [https://addyosmani.com/blog/good-spec/ How to write a good spec for AI agents]<span class="detalle">Guía de Addy Osmani sobre specs eficaces para agentes de IA · 2026</span>
</div>
<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 SDD y niveles de adopción de specs · Martin Fowler · 2025</span>
🏦 [https://scrummanager.com/skillarena/sdd-en-equipos-agiles '''SDD - Spec Driven Development en equipos ágiles''']<span class="detalle">Skill Arena · Scrum Manager</span>
</div>
</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 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 de GitHub sobre specs como contrato y fuente de verdad para IA · 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>


Line 406: Line 393:


<div class="bok-tags">
<div class="bok-tags">
[[Spec-Driven Development]] [[Spec writing]] [[Historia de usuario]] [[Criterios de aceptación]] [[Happy path]] [[Always / Ask First / Never]] [[Agente de IA]] [[Vibe engineering]] [[Brownfield]] [[Greenfield]]
[[Spec-Driven Development (SDD)]] [[Historia de usuario]] [[Criterios de aceptación]] [[Happy path]] [[Always / Ask First / Never]] [[Agente de IA]] [[Vibe engineering]] [[Brownfield]] [[Greenfield]]
</div>
</div>