OpenSpec desde cero
Guía en español de desarrollo guiado por especificaciones con OpenSpec: acuerda qué vas a construir antes de pedírselo a tu agente de IA. Primer cambio en 30 minutos, referencia del CLI, guía de adopción en equipo y manual en PDF.
Problema
Pedirle a un agente de IA que implemente algo sin acordar antes qué se va a construir produce código que hay que rehacer: requisitos implícitos, alcance que crece en mitad de la conversación y ninguna trazabilidad de por qué el sistema hace lo que hace. OpenSpec resuelve eso, pero su documentación está en inglés y da por sabidos los conceptos de spec-driven development.
Solución
Una guía en español que parte de cero: qué es OpenSpec en tres frases, el ciclo de trabajo de cuatro pasos (explorar, proponer, aplicar y archivar), un primer cambio guiado sobre un ejemplo real de reservas con Claude Code, la referencia de comandos del CLI y una guía para adoptarlo en equipo junto a Jira o Azure DevOps. Todo descargable además como manual en PDF.
Resultados
30 min
Primer cambio
4
Pasos del ciclo
3
Recorridos de lectura
OpenSpec desde cero es una guía práctica de desarrollo guiado por especificaciones (spec-driven development) para quien ya programa con agentes de IA y quiere dejar de improvisar. La idea central es sencilla: acordar por escrito qué se va a construir antes de pedírselo al agente.
El ciclo de trabajo
La guía articula todo alrededor de cuatro pasos:
- Explorar el cambio y su contexto.
- Proponer la especificación (
/opsx:propose): requisitos, escenarios y tareas. - Aplicar la implementación con el agente (
/opsx:apply) contra esa especificación. - Archivar el cambio (
/opsx:archive), de modo que la spec pase a ser documentación viva.
Tres recorridos
- Empieza: qué es OpenSpec y un primer cambio completo en unos 30 minutos, sobre un ejemplo de sistema de reservas.
- Referencia: los comandos del CLI, desde
openspec initen adelante. - Equipo: cómo adoptarlo en un equipo que ya trabaja con Jira o Azure DevOps.
El contenido completo se puede descargar como manual en PDF.
Galería
Qué aprendí
- → Especificar antes de generar: una propuesta revisable reduce las iteraciones con el agente más que cualquier prompt largo.
- → Las specs archivadas funcionan como documentación viva: el porqué de cada cambio queda junto al código.
- → Adoptar SDD en equipo pasa por encajarlo en el flujo existente (Jira, Azure DevOps), no por sustituirlo.
- → Enseñar desde cero obliga a separar el concepto de la herramienta: primero el ciclo, después los comandos.