Proposal y spec: el porqué y la fuente de verdad

El onboard trabaja con cuatro ficheros de documentación. Vamos con los dos primeros.

El proposal captura el porqué y el qué a alto nivel: el alcance del trabajo. Es lo que escribirías en una tarea de GitHub, Jira o Trello. Responde a tres cosas: por qué se hace el cambio, qué cambia y qué capacidades nuevas aparecen (y le pone nombre a cada una).

Para avanzar de un artefacto al siguiente, el comando es continue:

/opsx:continue   # claude code y otros

/opsx-continue   # opencode

Es la forma de llevar el proceso paso a paso, generando cada documento y dándote la opción de revisar antes de seguir.

El segundo fichero es la spec, y aquí está el corazón del SDD. La spec define qué construyes en términos precisos y comprobables. Se parece muchísimo a una historia de usuario o a un caso de prueba, con escenarios en formato cuándo / entonces:

Cuando el servidor arranca, entonces emite un log consistente que incluye la URL.

Esta spec es la fuente de verdad principal. El proposal lo podrías haber escrito tú a mano; la spec es lo que la IA va a respetar al construir.

En la siguiente, el diseño y el momento en que esto se convierte en código.