Recetas: feature, bugfix, refactor, paralelo
No todos los cambios necesitan el mismo recorrido. Estas recetas parten del flujo completo y lo ajustan al tipo de trabajo; los ejemplos usan una aplicación de gestión de reservas.
Receta 1: funcionalidad pequeña (camino rápido)
Sección titulada «Receta 1: funcionalidad pequeña (camino rápido)»/opsx:propose cancelacion-reservas- Revisa proposal y specs.
/opsx:apply/opsx:archive
Receta 2: bugfix
Sección titulada «Receta 2: bugfix»Igual que la receta 1, pero la propuesta se formula como comportamiento correcto y la delta spec usa MODIFIED sobre el requisito afectado. El bug queda documentado como requisito, con un escenario que lo cubre.
/opsx:propose fix-reserva-duplicadaReceta 3: explorar primero
Sección titulada «Receta 3: explorar primero»Para cambios con incertidumbre:
/opsx:exploresobre el área afectada. En Claude Code encaja con el plan mode (Shift+Tab), que impide editar mientras investigas.- Cuando haya claridad,
/opsx:propose: la propuesta aprovecha el contexto de la exploración.
Receta 4: cambios en paralelo
Sección titulada «Receta 4: cambios en paralelo»Cada change vive en su propia carpeta, así que no hay conflictos entre ellos. Para retomar uno concreto: /opsx:apply exportacion-pdf. Para trabajar en paralelo de verdad, combina OpenSpec con git worktrees (un directorio y una rama por change):
git worktree add ..\reservas-exportacion -b exportacion-pdfopenspec listgit worktree add ../reservas-exportacion -b exportacion-pdfopenspec listopenspec list muestra los changes activos y su progreso.
Receta 5: refactor sin cambio de comportamiento
Sección titulada «Receta 5: refactor sin cambio de comportamiento»Propuesta y tasks, sin delta specs: el comportamiento no cambia, así que no hay nada que fusionar. Archiva saltando la actualización de specs:
openspec archive refactor-repositorio-reservas --skip-specsopenspec archive refactor-repositorio-reservas --skip-specsReceta 6: control incremental (cambios grandes)
Sección titulada «Receta 6: control incremental (cambios grandes)»Con el perfil ampliado: /opsx:new → /opsx:continue (un artefacto cada vez, revisando entre medias) → /opsx:ff cuando el resto ya está claro.
Receta 7: aprender sobre el código real
Sección titulada «Receta 7: aprender sobre el código real»/opsx:onboard (perfil ampliado) guía un change completo sobre tu propio repositorio. Es la forma más rápida de que alguien nuevo vea el ciclo entero con código que conoce.