Ir al contenido
OpenSpec desde cero

// SPEC-DRIVEN DEVELOPMENT

OpenSpec
desde cero

Desarrollo guiado por especificaciones, explicado desde cero. Acuerda qué vas a construir antes de pedírselo a tu agente de IA.

Empieza en 30 minutos →Qué es OpenSpec
Manual en PDF 0,8 MB

Qué es OpenSpec en 3 frases

Sección titulada «Qué es OpenSpec en 3 frases»
  1. OpenSpec es una herramienta de línea de comandos para escribir especificaciones ligeras antes de programar con un agente de IA.
  2. Cada cambio empieza como una propuesta con requisitos y escenarios que tú y el agente revisáis juntos.
  3. Al terminar, esas especificaciones se fusionan con las del proyecto y quedan como documentación viva.

El método de un vistazo

Sección titulada «El método de un vistazo»
OpenSpec: desarrollo guiado por especificaciones con IA

Primero se acuerda la spec; después el agente implementa contra ella.

1 Fundamentos

  • Humanos y agentes de IA acuerdan qué construir antes de escribir código, y ese acuerdo vive en Git.
  • openspec/specs/ Fuente de verdad: cómo se comporta el sistema hoy, por dominios.
  • openspec/changes/ Cada cambio es un delta: solo describe lo que añade, modifica o elimina.
  • Brownfield primero: se introduce en un proyecto existente con un piloto acotado, sin documentarlo todo de golpe.
  • openspec init --tools Agnóstico de herramienta: admite más de 40 asistentes.

Amplía: Qué es OpenSpec · Proyectos existentes

2 Los cuatro artefactos de un change

Change

  • proposal.mdIntención, alcance y enfoque.
  • specs/Delta specs con requisitos SHALL y escenarios WHEN / THEN.
  • design.mdDecisiones técnicas.
  • tasks.mdChecklist de implementación con progreso.

Amplía: Conceptos · Formato de specs

3 El ciclo diario con /opsx

  1. /opsx:exploreInvestiga el problema sin escribir artefactos ni código.
  2. /opsx:proposeCrea el change con proposal, specs, design y tasks.
  3. /opsx:applyImplementa las tareas y las marca al completarlas.
  4. /opsx:verifyComprueba que el código cumple specs, design y tasks.perfil ampliado
  5. /opsx:archiveFusiona las delta specs y archiva el change.

Amplía: Flujo /opsx · Comandos de chat

4 En equipo

  • Backlog en Jira o Azure DevOps: el agente lee el ticket vía MCP, en solo lectura.
  • openspec validate --all --strict En la pipeline de cada PR, con una versión fija de OpenSpec.
  • openspec/specs/ Regla de oro: no se edita a mano; solo cambia con /opsx:archive o /opsx:sync.

Amplía: Jira · Azure DevOps · Validación en CI · Adopción

El ciclo de trabajo

Sección titulada «El ciclo de trabajo»
  1. 01/opsx:explorePiensa el cambio antes de escribir nada.
  2. 02/opsx:proposePropuesta, specs, diseño y tareas.
  3. 03/opsx:applyEl agente lo implementa contra la spec.
  4. 04/opsx:archiveFusiona las specs y cierra el cambio.

Elige tu recorrido

Sección titulada «Elige tu recorrido»
/equipo/adopcion/RecomendadoEquipo →Vas a adoptarlo en un equipo: plan de adopción, Jira o Azure DevOps y CI./empieza/que-es/Inicio →Nunca has usado OpenSpec: qué es, conceptos, instalación y tu primer cambio./referencia/cli/Consulta →Buscas un comando o una plantilla concreta: usa el buscador o la referencia.