Para devs · onboarding
El repo ya viene configurado: las skills, la constitución y OpenSpec viajan con él. Instalas el CLI una vez, y después corres el mismo ciclo para cada User Story.
Parte A
Lo único que se instala por máquina es el CLI. Todo lo demás (skills, constitución, OpenSpec) ya está versionado en el repo.
El comando queda como dai. gh (o glab) lo usa dai pr para crear la PR.
Al clonar (o hacer pull) llegan las skills, la constitución y OpenSpec. No corres dai init: eso ya lo hizo quien preparó el repo.
.env con tu tokenCopia el ejemplo y pega tu token del tracker en la variable correspondiente.
Pega solo el token, sin comentarios ni espacios en esa línea. El .env está gitignoreado: no se commitea.
Para que carguen las skills (/grill-*, /tdd, /link-us, /dai-review) y los comandos /opsx:*. Se cargan al arrancar.
Verde en skills + el tracker con token = listo para trabajar.
Parte B
El mismo recorrido para cada historia. Cada paso tiene una skill de IA o un comando que hace el trabajo pesado. QUÉ CÓMO máquina
dai trae la User Story del tracker, crea la branch y siembra el link — correcto por construcción, sin tipear el ID a mano. Parte siempre de tu rama base actualizada.
dai link-us <ID> → branch + implements.yamlExploras la solución y generas la propuesta, el diseño y las tareas — co-localizados con el link, en la misma branch.
/opsx:explore → /opsx:proposeTDD en rebanadas verticales: un test, el código mínimo, repetir. La IA escribe el test como spec ejecutable.
/opsx:apply · /tdd¿Tu código sigue al día con la US? dai re-deriva el hash de la US viva y compara. Si el QUÉ cambió, te avisa y te dice cómo resincronizar.
dai check → ✅ al día / ⚠️ atrasadoRevisas tu propio código + smoke local, y dai arma la PR desde el template, precargada con la US, el estado del check y los enlaces.
dai pr · luego /dai-review <PR> (la revisa un compañero)Al mergear, dai escribe en el tracker quién implementó qué. Después cierra la US: vuelve a la base y borra la branch.
dai stamp → dai done<ID> de la US es el identificador del tracker. En ClickUp, de una URL
como app.clickup.com/t/9013…/86ajecfmy, el ID es 86ajecfmy. El método
y las convenciones del repo están en su CLAUDE.md.
Parte C
Los tres tropiezos más comunes al arrancar, y cómo salir de ellos.
dai link-us tira un error de ByteStringTu línea del token en el .env tiene un comentario o un espacio de más.
Deja solo el token, sin nada después.
/opsx:*Reinicia el asistente / IDE. Las skills y los comandos se cargan al arrancar.
dai doctor en rojoSigue lo que indica cada línea: casi siempre es el token del tracker o falta reiniciar.