/landing-report — Panel de Control de Cola de Versiones
Preámbulo (ejecutar primero)
_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/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=$(~/.claude/skills/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=$(~/.claude/skills/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 <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/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=$(~/.claude/skills/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=$(~/.claude/skills/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":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "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 "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
~/.claude/skills/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 "$(~/.claude/skills/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
~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
fi
else
echo "LEARNINGS: 0"
fi
~/.claude/skills/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=$(~/.claude/skills/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 ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
_VENDORED="yes"
fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true
Operaciones Seguras en Modo Plan
En modo plan, están permitidas 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; la primera AskUserQuestion es el flujo de trabajo entrando en modo plan, no una violación del mismo. AskUserQuestion satisface el requisito de fin de turno del modo plan. En un punto STOP, detente inmediatamente. No continúes el flujo de trabajo ni llames a ExitPlanMode allí. Los comandos marcados como "PLAN MODE EXCEPTION — ALWAYS RUN" 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 abandones el modo plan.
Si PROACTIVE es "false", no auto-invoques ni sugieras habilidades de forma proactiva. Si una habilidad parece útil, pregunta: "Creo que /skillname podría ayudar aquí. ¿Quieres que lo ejecute?"
Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen como ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Si la salida muestra UPGRADE_AVAILABLE <old> <new>: lee ~/.claude/skills/gstack/gstack-upgrade/SKILL.md y sigue el "flujo de actualización en línea" (auto-actualización si está configurada, de lo contrario AskUserQuestion con 4 opciones, escribe el 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 true, omite el descubrimiento de funciones.
Descubrimiento de funciones, máximo un aviso por sesión:
- Falta
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para auto-commits de checkpoint continuo. Si se acepta, ejecuta~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Siempre toca el marcador. - Falta
~/.claude/skills/gstack/.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 con 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 para primer uso, preguntas enmarcadas en resultados, prosa más corta. ¿Mantener el predeterminado o restaurar el conciso?
Opciones:
- A) Mantener el nuevo predeterminado (recomendado — una buena escritura ayuda a todos)
- B) Restaurar prosa V0 — establecer
explain_level: terse
Si A: deja explain_level sin establecer (por defecto es default).
Si B: ejecuta ~/.claude/skills/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
Omitir si WRITING_STYLE_PENDING es no.
Si LAKE_INTRO es no: di "gstack sigue el principio de Hervir el Lago — haz la tarea completa cuando la IA hace 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 sobre telemetría una vez mediante AskUserQuestion:
Ayuda a gstack a mejorar. Comparte solo datos de uso: habilidad, duración, fallos, ID de dispositivo estable. Sin código, rutas de archivo o nombres de repositorio.
Opciones:
- A) ¡Ayuda a gstack a mejorar! (recomendado)
- B) No, gracias
Si A: ejecuta ~/.claude/skills/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 anónimo está bien
- B) No, gracias, completamente desactivado
Si B→A: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous
Si B→B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry off
Siempre ejecuta:
touch ~/.gstack/.telemetry-prompted
Omitir si TEL_PROMPTED es yes.
Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: pregunta una vez:
¿Dejar que gstack sugiera habilidades de forma proactiva, como /qa para "¿esto funciona?" o /investigate para errores?
Opciones:
- A) Mantenerlo activado (recomendado)
- B) Desactivarlo — escribiré /comandos yo mismo
Si A: ejecuta ~/.claude/skills/gstack/bin/gstack-config set proactive true
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set proactive false
Siempre ejecuta:
touch ~/.gstack/.proactive-prompted
Omitir si PROACTIVE_PROMPTED es 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) Añadir reglas de enrutamiento a CLAUDE.md (recomendado)
- B) No, gracias, invocaré las habilidades manualmente
Si A: Añade esta sección al final de CLAUDE.md:
## Enrutamiento de habilidades
Cuando la solicitud del usuario coincida con una habilidad disponible, invócala mediante la herramienta de habilidad. En caso de duda, invoca la habilidad.
Reglas clave de enrutamiento:
- Ideas/lluvia de ideas de producto → 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
- Tubería completa de revisión → invocar /autoplan
- Errores/fallos → invocar /investigate
- QA/pruebas de comportamiento del sitio → invocar /qa o /qa-only
- Revisión de código/comprobación de diff → invocar /review
- Pulido visual → invocar /design-review
- Envío/despliegue/PR → invocar /ship o /land-and-deploy
- Guardar progreso → invocar /context-save
- Reanudar contexto → invocar /context-restore
Luego confirma el cambio: git add CLAUDE.md && git commit -m "chore: add gstack skill routing rules to CLAUDE.md"
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set routing_declined true y di que pueden reactivarlo con gstack-config set routing_declined false.
Esto solo ocurre una vez por proyecto. Omitir si HAS_ROUTING es yes o ROUTING_DECLINED es true.
Si VENDORED_GSTACK es yes, advierte una vez mediante AskUserQuestion a menos que exista ~/.gstack/.vendoring-warned-$SLUG:
Este proyecto tiene gstack vendido en
.claude/skills/gstack/. El vendoring está obsoleto. ¿Migrar al modo de equipo?
Opciones:
- A) Sí, migrar al modo de equipo ahora
- B) No, lo manejaré yo mismo
Si A:
- Ejecuta
git rm -r .claude/skills/gstack/ - Ejecuta
echo '.claude/skills/gstack/' >> .gitignore - Ejecuta
~/.claude/skills/gstack/bin/gstack-team-init required(ooptional) - Ejecuta
git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrate gstack from vendored to team mode" - Informa al usuario: "Hecho. Cada desarrollador ahora ejecuta:
cd ~/.claude/skills/gstack && ./setup --team"
Si B: di "De acuerdo, estás por tu cuenta para mantener la copia vendida actualizada."
Siempre ejecuta (independientemente de la elección):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
Si el marcador existe, omitir.
Si SPAWNED_SESSION es "true", estás ejecutando dentro de una sesión generada por un
orquestador de IA (ej., OpenClaw). En sesiones generadas:
- NO uses AskUserQuestion para avisos interactivos. Elige automáticamente la opción recomendada.
- NO ejecutes comprobaciones de actualización, avisos de telemetría, inyección de enrutamiento o introducción del lago.
- Concéntrate en completar la tarea e informar los resultados mediante salida en prosa.
- Termina con un informe de finalización: qué se envió, decisiones tomadas, cualquier cosa incierta.
Formato de AskUserQuestion
Cada AskUserQuestion es un resumen de decisión y debe enviarse como tool_use, no como prosa.
D<N> — <título de pregunta de una línea>
Proyecto/rama/tarea: <1 oración breve de contexto usando _BRANCH>
ELI10: <inglés sencillo que un adolescente de 16 años podría seguir, 2-4 oraciones, nombra los riesgos>
Riesgos si elegimos mal: <una oración sobre lo que se rompe, lo que ve el usuario, lo que se pierde>
Recomendación: <elección> porque <razón de una línea>
Integridad: A=X/10, B=Y/10 (o: Nota: las opciones difieren en tipo, no en cobertura — sin puntuación de integridad)
Pros / contras:
A) <etiqueta de opción> (recomendado)
✅ <pro — concreto, observable, ≥40 caracteres>
❌ <contra — honesto, ≥40 caracteres>
B) <etiqueta de opción>
✅ <pro>
❌ <contra>
Neto: <síntesis de una línea de lo que realmente estás intercambiando>
Numeración D: la primera pregunta en una invocación de habilidad es D1; increméntate tú mismo. Esta es una instrucción a nivel de modelo, no un contador en tiempo de ejecución.
ELI10 siempre está presente, en inglés sencillo, no nombres de funciones. La Recomendación SIEMPRE está presente. Mantén la etiqueta (recomendado); AUTO_DECIDE depende de ella.
Integridad: usa Completeness: N/10 solo cuando las opciones difieren en cobertura. 10 = completo, 7 = camino feliz, 3 = atajo. Si las opciones difieren en tipo, escribe: Nota: las opciones difieren en tipo, no en cobertura — sin puntuación de integridad.
Pros / contras: usa ✅ y ❌. Mínimo 2 pros y 1 contra por opción cuando la elección es real; Mínimo 40 caracteres por viñeta. Escape de parada dura para confirmaciones unidireccionales/destructivas: ✅ Sin contras — esta es una elección de parada dura.
Postura neutral: Recomendación: <predeterminado> — esto es una cuestión de gusto, sin preferencia fuerte de ninguno de los lados; (recomendado) PERMANECE en la opción predeterminada para AUTO_DECIDE.
Escalas de esfuerzo en ambas direcciones: cuando una opción implica esfuerzo, etiqueta tanto el tiempo del equipo humano como el de CC+gstack, ej., (human: ~2 days / CC: ~15 min). Hace visible la compresión de IA en el momento de la decisión.
La línea neta cierra el intercambio. Las instrucciones por habilidad pueden añadir reglas más estrictas.
Autocomprobación antes de emitir
Antes de llamar a AskUserQuestion, verifica:
- Encabezado D presente
- Párrafo ELI10 presente (también línea de riesgos)
- Línea de recomendación presente con razón concreta
- Puntuación de integridad (cobertura) O nota de tipo presente (tipo)
- Cada opción tiene ≥2 ✅ y ≥1 ❌, cada una ≥40 caracteres (o escape de parada dura)