/landing-report — Panel 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 entradas cargadas"
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 el plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo del plan, y open para artefactos generados.
Invocación de Skill Durante el Modo Plan
Si el usuario invoca una skill en modo plan, la skill tiene prioridad sobre el comportamiento genérico del modo plan. Trata el archivo de skill 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 nativo; ver "Formato AskUserQuestion → Resolución de herramienta") satisface el requisito de fin de turno del modo plan. Si ninguna variante es invocable, la skill está BLOQUEADA — detente e informa BLOQUEADA — AskUserQuestion no disponible según la regla de Formato AskUserQuestion. En un punto STOP, detente inmediatamente. No continúes el flujo de trabajo ni llames a ExitPlanMode allí. Los comandos marcados como "EXCEPCIÓN DEL MODO PLAN — EJECUTAR SIEMPRE" se ejecutan. Llama a ExitPlanMode solo después de que el flujo de trabajo de la skill se complete, o si el usuario te dice que canceles la skill o salgas del modo plan.
Si PROACTIVE es "false", no invoques automáticamente ni sugieras skills de forma proactiva. Si una skill parece útil, pregunta: "Creo que /nombre-de-skill podría ayudar aquí — ¿quieres que la ejecute?"
Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen en ~/.claude/skills/gstack/[nombre-skill]/SKILL.md.
Si la salida muestra UPGRADE_AVAILABLE <antigua> <nueva>: lee ~/.claude/skills/gstack/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 <desde> <hasta>: imprime "Ejecutando gstack v{hasta} (¡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 confirmaciones automáticas 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 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: glosas de jerga para primer uso, preguntas basadas en resultados, prosa más corta. ¿Mantener el predeterminado o restaurar el estilo conciso?
Opciones:
- A) Mantener el nuevo 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 ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.
Ejecutar siempre (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. Leer 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 la respuesta 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 que gstack mejore. Comparte solo datos de uso: skill, duración, fallos, ID de dispositivo estable. Sin código, rutas de archivos ni nombres de repositorio.
Opciones:
- A) ¡Ayuda a que gstack mejore! (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, 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
Ejecutar siempre:
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 skills 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 ~/.claude/skills/gstack/bin/gstack-config set proactive true
Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set proactive false
Ejecutar siempre:
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 skills.
Opciones:
- A) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
- B) No, gracias, invocaré las skills manualmente
Si A: Agrega esta sección al final de CLAUDE.md:
## Skill routing
Cuando la solicitud del usuario coincida con una skill disponible, invócala mediante la herramienta Skill. En caso de duda, invoca la skill.
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 de QA/pruebas → invocar /qa o /qa-only
- Revisión de código/verificació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: agregar reglas de enrutamiento de skills de gstack a 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 empaquetado en
.claude/skills/gstack/. El empaquetado está obsoleto. ¿Migrar al modo equipo?
Opciones:
- A) Sí, migrar al modo 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: migrar gstack de empaquetado a modo equipo" - Dile al usuario: "Hecho. Cada desarrollador ahora ejecuta:
cd ~/.claude/skills/gstack && ./setup --team"
Si B: di "OK, depende de ti mantener la copia empaquetada actualizada."
Ejecutar siempre (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, omítelo.
Si SPAWNED_SESSION es "true", te estás ejecutando dentro de una sesión generada por un orquestador de IA (por ejemplo, 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 AskUserQuestion
Resolución de herramienta (leer primero)
"AskUserQuestion" puede resolverse en dos herramientas en tiempo de ejecución: la variante MCP del host (por ejemplo, mcp__conductor__AskUserQuestion — aparece en tu lista de herramientas cuando el host la registra) o la herramienta nativa de Claude Code.
Regla: si alguna variante mcp__*__AskUserQuestion está en tu lista de herramientas, prefierela. Los hosts pueden deshabilitar la AUQ nativa mediante --disallowedTools AskUserQuestion (Conductor lo hace, por defecto) y enrutar a través de su variante MCP; llamar a la nativa allí falla silenciosamente. Las mismas preguntas/opciones; se aplica el mismo formato de resumen de decisión.
Si no aparece ninguna variante de AskUserQuestion en tu lista de herramientas, esta skill está BLOQUEADA. Detente, informa BLOQUEADA — AskUserQuestion no disponible y espera al usuario. No escribas decisiones en el archivo del plan como sustituto, no las emitas como prosa y te detengas, y no decidas automáticamente en silencio (solo las opciones /plan-tune AUTO_DECIDE autorizan la selección automática).
Formato
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 de contexto breve usando _BRANCH>
ELI10: <inglés sencillo que un adolescente podría seguir, 2-4 oraciones, menciona lo que está en juego>
Lo que está en juego si elegimos mal: <una oración sobre qué se rompe, qué ve el usuario, qué se pierde>
Recomendación: <opció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> (recomendada)
✅ <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 skill es D1; incrementa 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 (recomendada); AUTO_DECIDE depende de ella.
Integridad: usa Integridad: N/10
…
[truncado para traducción]