De tu código
a tu primera spec
Todo lo que se enseña sobre specs asume que empiezas de cero. Esto va al revés: pega lo que ya tienes y te devuelve la spec de lo que hace hoy, en el formato nativo de OpenSpec.
Y ahora, ¿qué hago con esto?
Cuatro pasos para que la spec deje de ser un archivo suelto y pase a ser la verdad de tu repo.
Instala OpenSpec
npm install -g @fission-ai/openspec
Necesitas Node 20.19 o superior.
Inicializa en tu repo
openspec init
Crea el directorio openspec/ y los comandos de tu agente (Claude Code, Cursor…).
Coloca la spec que acabas de descargar
openspec/specs/<tu-dominio>/spec.md
Es tu línea base: lo que el sistema hace hoy. Léela y corrige lo que esté mal.
Propón tu primer cambio
/opsx:propose
A partir de aquí cada cambio declara solo lo que añade o modifica. Eso es lo que hace viable meter specs en un proyecto viejo.
¿Dudas entre OpenSpec y Spec Kit? La comparativa te lo resuelve en 30 segundos.
Documentar lo que hay es el paso 1, no el método
Esta herramienta te da la línea base. Lo que hagas con ella —cómo escribes cada cambio, cómo revisas, cuándo archivas— es el método. El capítulo 9 del libro va entero de brownfield.