/landing-report — Panel de Cola de Versiones
Preámbulo (ejecutar primero)
_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
GSTACK_ROOT="$HOME/.cursor/skills/gstack"
[ -n "$_ROOT" ] && [ -d "$_ROOT/.cursor/skills/gstack" ] && GSTACK_ROOT="$_ROOT/.cursor/skills/gstack"
GSTACK_BIN="$GSTACK_ROOT/bin"
GSTACK_BROWSE="$GSTACK_ROOT/browse/dist"
GSTACK_DESIGN="$GSTACK_ROOT/design/dist"
_UPD=$($GSTACK_BIN/gstack-update-check 2>/dev/null || .cursor/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$($GSTACK_BIN/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$($GSTACK_BIN/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <($GSTACK_BIN/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$($GSTACK_BIN/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Host de Conductor: AskUserQuestion no es confiable aquí (nativo deshabilitado, variante
# MCP inestable), por lo que las habilidades convierten las decisiones en prosa en lugar de llamar a la
# herramienta. Se protege con !headless para que una ejecución de eval/CI DENTRO de Conductor (GSTACK_HEADLESS)
# aún BLOQUEE en lugar de renderizar prosa para nadie.
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Detección de proyecto en primera ejecución: ejecutar el detector SOLO en la primera ejecución de habilidad
# (ACTIVATED=no, interactivo) para que no esté en la ruta crítica en ejecuciones posteriores.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$($GSTACK_BIN/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$($GSTACK_BIN/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$($GSTACK_BIN/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$($GSTACK_BIN/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
if [ -f "$_PF" ]; then
if [ "$_TEL" != "off" ] && [ -x "$GSTACK_BIN/gstack-telemetry-log" ]; then
$GSTACK_BIN/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
fi
rm -f "$_PF" 2>/dev/null || true
fi
break
done
eval "$($GSTACK_BIN/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
_LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
echo "LEARNINGS: $_LEARN_COUNT entries loaded"
if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
$GSTACK_BIN/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
$GSTACK_BIN/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
_HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$($GSTACK_BIN/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".cursor/skills/gstack" ] && [ ! -L ".cursor/skills/gstack" ]; then
if [ -f ".cursor/skills/gstack/VERSION" ] || [ -d ".cursor/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$($GSTACK_BIN/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$($GSTACK_BIN/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Indicador de modo plan para habilidades como /spec que cambian el comportamiento según el estado del modo plan.
# Claude Code expone el modo plan a través de recordatorios del sistema; detectamos de la mejor manera posible
# desde CLAUDE_PLAN_FILE (establecido por el arnés cuando el modo plan está activo) y
# recurrimos a "inactive". Los hosts de Codex y el modo de ejecución de Claude terminan como
# inactivos, que es el valor predeterminado seguro (por defecto es el pipeline de archivo+ejecución).
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
export GSTACK_PLAN_MODE="active"
else
export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
Operaciones seguras en modo plan
En modo plan, se permiten porque informan al plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo del plan, y open para artefactos generados.
Invocación de habilidad durante el modo plan
Si el usuario invoca una habilidad en modo plan, la habilidad tiene prioridad sobre el comportamiento genérico del modo plan. Trata el archivo de habilidad como instrucciones ejecutables, no como referencia. Síguelo paso a paso comenzando desde el Paso 0; el primer AskUserQuestion es el flujo de trabajo entrando en modo plan, no una violación del mismo. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; ver "Formato AskUserQuestion → Resolución de herramienta") satisface el requisito de fin de turno del modo plan. Si AskUserQuestion no está disponible o una llamada falla, sigue el fallo por falla del Formato AskUserQuestion: headless → BLOQUEADO; interactive → el fallback de prosa (también satisface el fin de turno). En un punto de PARADA, detente inmediatamente. No continúes el flujo de trabajo ni llames a ExitPlanMode allí. Los comandos marcados como "EXCEPCIÓN DE MODO PLAN — EJECUTAR SIEMPRE" se ejecutan. Llama a ExitPlanMode solo después de que el flujo de trabajo de la habilidad se complete, o si el usuario te dice que canceles la habilidad o salgas del modo plan.
Si PROACTIVE es "false", no invoques automáticamente ni sugieras habilidades de forma proactiva. Si una habilidad parece útil, pregunta: "Creo que /nombre-de-habilidad podría ayudar aquí — ¿quieres que la ejecute?"
Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen como $GSTACK_ROOT/[skill-name]/SKILL.md.
Si la salida muestra UPGRADE_AVAILABLE <old> <new>: lee $GSTACK_ROOT/gstack-upgrade/SKILL.md y sigue el "Flujo de actualización en línea" (actualización automática si está configurada, de lo contrario AskUserQuestion con 4 opciones, escribe estado de posposición si se rechaza).
Si la salida muestra JUST_UPGRADED <from> <to>: imprime "Ejecutando gstack v{to} (¡recién actualizado!)". Si SPAWNED_SESSION es verdadero, omite el descubrimiento de funciones.
Descubrimiento de funciones, máximo un aviso por sesión:
- Falta
$GSTACK_ROOT/.feature-prompted-continuous-checkpoint: AskUserQuestion para confirmaciones automáticas de punto de control continuo. Si se acepta, ejecuta$GSTACK_BIN/gstack-config set checkpoint_mode continuous. Siempre toca el marcador. - Falta
$GSTACK_ROOT/.feature-prompted-model-overlay: informa "Las superposiciones de modelo están activas. MODEL_OVERLAY muestra el parche." Siempre toca el marcador.
Después de los avisos de actualización, continúa el flujo de trabajo.
Si WRITING_STYLE_PENDING es yes: pregunta una vez sobre el estilo de escritura:
Los avisos v1 son más simples: glosarios de jerga en primer uso, preguntas enmarcadas en resultados, prosa más corta. ¿Mantener el valor predeterminado o restaurar el terse?
Opciones:
- A) Mantener el nuevo valor predeterminado (recomendado — una buena escritura ayuda a todos)
- B) Restaurar la prosa V0 — establecer
explain_level: terse
Si A: deja explain_level sin establecer (por defecto es default).
Si B: ejecuta $GSTACK_BIN/gstack-config set explain_level terse.
Siempre ejecuta (independientemente de la elección):
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Saltar si WRITING_STYLE_PENDING es no.
Si LAKE_INTRO es no: di "gstack sigue el principio Boil the Ocean — haz la tarea completa cuando la IA haga que el costo marginal sea casi cero. Lee más: https://garryslist.org/posts/boil-the-ocean" Ofrece abrir:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
Ejecuta open solo si es sí. Siempre ejecuta touch.
Si TEL_PROMPTED es no Y LAKE_INTRO es yes: pregunta telemetría una vez mediante AskUserQuestion:
Ayuda a que gstack mejore. Comparte solo datos de uso: habilidad, duración, fallos, ID de dispositivo estable. Sin código ni rutas de archivos. El nombre de tu repositorio se registra solo localmente y se elimina antes de cualquier carga.
Opciones:
- A) ¡Ayuda a que gstack mejore! (recomendado)
- B) No, gracias
Si A: ejecuta $GSTACK_BIN/gstack-config set telemetry community
Si B: pregunta de seguimiento:
El modo anónimo envía solo uso agregado, sin ID único.
Opciones:
- A) Claro, el modo anónimo está bien
- B) No, gracias, completamente desactivado
Si B→A: ejecuta $GSTACK_BIN/gstack-config set telemetry anonymous
Si B→B: ejecuta $GSTACK_BIN/gstack-config set telemetry off
Siempre ejecuta:
touch ~/.gstack/.telemetry-prompted
Saltar si TEL_PROMPTED es yes.
Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: pregunta una vez:
¿Permitir que gstack sugiera habilidades de forma proactiva, como /qa para "¿esto funciona?" o /investigate para errores?
Opciones:
- A) Mantenerlo activado (recomendado)
- B) Desactivarlo — escribiré los /comandos yo mismo
Si A: ejecuta $GSTACK_BIN/gstack-config set proactive true
Si B: ejecuta $GSTACK_BIN/gstack-config set proactive false
Siempre ejecuta:
touch ~/.gstack/.proactive-prompted
Saltar si PROACTIVE_PROMPTED es yes.
Orientación de primera ejecución (única)
Si ACTIVATED es no (primera ejecución de habilidad en esta máquina) Y el preámbulo imprimió un valor FIRST_TASK: no vacío que NO es nongit: muestra UNA línea corta y específica del proyecto mapeada desde el token, como aviso, luego CONTINÚA con lo que sea que el usuario haya pedido — no detengas su tarea. Mapa el token: greenfield → "Repositorio nuevo — dale forma primero con /spec o /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Hay código aquí — /qa para verlo funcionar, o /investigate si algo está mal." branch_ahead → "Trabajo no enviado en esta rama — /review luego /ship." dirty_default → "Cambios no confirmados — /review antes de confirmar." clean_default → "Elige uno: /spec, /investigate o /qa." Luego sustituye el token que viste por TASK_TOKEN y ejecuta (mejor esfuerzo), y marca activado:
$GSTACK_BIN/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true
Si ACTIVATED es no pero FIRST_TASK: está vacío o es nongit (headless, no git, o nada procesable): no muestres nada, solo ejecuta touch ~/.gstack/.activated 2>/dev/null || true.
Si no, si ACTIVATED es yes Y FIRST_LOOP_SHOWN es no: di una vez como aviso (luego continúa):
Consejo: gstack da resultados cuando completas un ciclo — planificar → revisar → enviar. Un primer ciclo común:
/office-hourso/specpara darle forma,/plan-eng-reviewpara asegurarlo, luego/ship.
Luego ejecuta touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.
Saltar esta sección si ACTIVATED y FIRST_LOOP_SHOWN son ambos yes.
Si HAS_ROUTING es no Y ROUTING_DECLINED es false Y PROACTIVE_PROMPTED es yes:
Verifica si existe un archivo CLAUDE.md en la raíz del proyecto. Si no existe, créalo.
Usa AskUserQuestion:
gstack funciona mejor cuando el CLAUDE.md de tu proyecto incluye reglas de enrutamiento de habilidades.
Opciones:
- A) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
- B) No, gracias, invocaré las habilidades manualmente
Si A: Agrega esta sección al final de CLAUDE.md:
## Enrutamiento de habilidades
Cuando la solicitud del usuario coincida con una habilidad disponible, invócala a través de la herramienta Skill. En caso de duda, invoca la habilidad.
Reglas de enrutamiento clave:
- Ideas de producto/lluvia de ideas → invocar /office-hours
- Estrategia/alcance → invocar /plan-ceo-review
- Arquitectura → invocar /plan-eng-review
- Sistema de diseño/revisión de plan → invocar /design-consultation o /plan-design-review
- Pipeline de revisión completo → invocar /autoplan
- Errores/fallos → invocar /investigate
- Comportamiento del sitio QA/pruebas → invocar /qa o /qa-only
- Revisión de código/verificación de diff → invocar /review
- Pulido visual → invocar /design-review
- Enviar/desplegar/PR → invocar /ship o /land-and-deploy
- Guardar progreso → invocar /context-save
- Reanudar contexto → invocar /context-restore
- Redactar una especificación/tarea lista para backlog → invocar /spec
Luego confirma el cambio: git add CLAUDE.md && git commit -m "chore: agregar reglas de enrutamiento de habilidades de gstack a CLAUDE.md"
Si B: ejecuta $GSTACK_BIN/gstack-config set routing_declined true
Luego ejecuta touch ~/.gstack/.routing-prompted 2>/dev/null || true.
Saltar si HAS_ROUTING es yes o ROUTING_DECLINED es true.
Pregunta de trabajo inactivo (después del preámbulo)
Si la sesión es interactiva (SESSION_KIND no es headless), la rama actual (_BRANCH) tiene cambios sin confirmar (sin archivos staged, o staged+unstaged según la semántica de git status --porcelain), Y NO hay un indicador .gstack/.idle-question-asked-<branch> para esta rama:
- Verifica si hay trabajo en progreso más antiguo:
git log --oneline origin/$(git symbolic-ref --short HEAD 2>/dev/null || echo main)..HEAD 2>/dev/null | head -1 - No preguntes si:
- Último commit tiene menos de 2 minutos de antigüedad (sospecha de aviso recién ejecutado)
_BRANCHcontienesandbox,scratch,wipodraft(ramas desechables)
- Pregunta exactamente una vez por rama, sin repreguntar
Usa AskUserQuestion:
Veo trabajo sin confirmar en
_BRANCH. ¿Debería abrir una sugerencia /review o /ship?
Opciones:
- Sí, ábrelo
- No, estoy en ello
Marca como preguntado: touch ~/.gstack/.idle-question-asked-$(echo "$_BRANCH" | sed 's/[^a-zA-Z0-9._-]/_/g') 2>/dev/null || true
Pregunta de commit fantasma
Si el preámbulo no encontró commits nuevos desde main en la rama actual (es decir, git log --oneline origin/$(git symbolic-ref --short HEAD 2>/dev/null || echo main)..HEAD 2>/dev/null está vacío), Y hay cambios sin confirmar EN el índice (staged), Y no hay un indicador .gstack/.ghost-commit-question-asked para esta sesión, Y la sesión es interactiva:
Pregunta una vez por sesión:
Detecté cambios preparados (staged) sin commits nuevos. ¿Debería hacer un 'commit fantasma' para desbloquear el pipeline de revisión? Los cambios no se enviarán a la rama.
Opciones:
- Sí, haz commit fantasma
- No, gracias
Si Sí: ejecuta:
git commit --allow-empty -m "[gstack] ghost commit (scaffold for review pipeline)"
Luego marca: touch ~/.gstack/.ghost-commit-question-asked-$$ 2>/dev/null || true
Saltar si el indicador ya existe.
Flujo de trabajo principal (después del preámbulo)
Paso 1 — Recopilar información
Ejecuta:
cd "$_ROOT"
$GSTACK_BIN/gstack-landing-report --mode claude
Paso 2 — Renderizar resumen
Renderiza la salida como una tabla Markdown (estilo panel). Columnas:
| Slot de VERSIÓN | Estado | PR # | Rama | Prioridad |
|---|---|---|---|---|
| v0.1.0 | Reclamado | #42 | feat/foo | alta |
| v0.1.1 | Libre | — | — | — |
| v0.2.0 | Reclamado | #45 | fix/bar | media |
Debajo, enumera los espacios de trabajo de Conductor que tienen WIP.
Paso 3 — Próximo paso
Tu capacidad para sugerir un próximo paso depende de tu evaluación de la información. Si es apropiado, sugiere /review o /ship. Si no, di "El informe de aterrizaje está arriba — sin obstrucciones." Siempre ofrece abrir el panel de navegación: $GSTACK_BROWSE/gstack-landing.html.
Pregunta de destino de versión (después de cada informe de aterrizaje)
Si el modo de repositorio es stack (es decir, REPO_MODE: stack), la rama actual tiene commits sin enviar, Y es interactivo:
Después de mostrar el informe de aterrizaje, pregunta:
¿Debería apuntar
/shipa un destino de versión específico?
Opciones:
- No, mantener por defecto (main)
- Sí, configurar para esta rama
Si "Sí, configurar para esta rama": ejecuta $GSTACK_BIN/gstack-config set version_target <rambda> donde <rambda> se obtiene preguntando por un destino de versión específico.
Modo headless
En modo headless (sesión de CI/evaluación): ejecuta gstack-landing-report --mode claude y genera JSON estructurado en lugar de Markdown. Sin interactividad. No preguntes.
Generado por gstack — panel de cola de ship.