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":"gstack","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":"gstack","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, se permiten porque informan el plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo de 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 no hay variante invocable, la habilidad 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 "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 ni sugieras habilidades automáticamente. 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" (autoactualizar si está configurado, 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 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 commits automáticos de Continuous checkpoint. 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: glosarios de jerga para primer uso, preguntas enmarcadas en resultados, prosa más corta. ¿Mantener el predeterminado o restaurar el telegráfico?
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 configurar (predeterminado a 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
Saltar si WRITING_STYLE_PENDING es no.
Si LAKE_INTRO es no: di "gstack sigue el principio Hervir el Lago, haz lo completo cuando la IA hace que el costo marginal sea casi nulo. 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
Solo ejecuta open 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 gstack a mejorar. Comparte solo datos de uso: habilidad, duración, fallos, ID de dispositivo estable. Sin código, rutas de archivos ni 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 seguimiento:
El modo anónimo envía solo datos agregados, 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
Saltar si TEL_PROMPTED es yes.
Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: pregunta una vez:
¿Dejar que gstack sugiera habilidades automáticamente, como /qa para "¿esto funciona?" o /investigate para errores?
Opciones:
- A) Mantenerlo activado (recomendado)
- B) Desactivarlo. Escribiré /commands 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
Saltar 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) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
- B) No, gracias, invocaré habilidades manualmente
Si A: Agrega esta sección al final de CLAUDE.md:
## Skill routing
Cuando la solicitud del usuario coincida con una habilidad disponible, invócala mediante la herramienta Skill. En caso de duda, invoca la habilidad.
Reglas clave de enrutamiento:
- Ideas de productos/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 de sitio 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 habilidades 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. Saltar 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 añadido como vendored en
.claude/skills/gstack/. El vendoring está obsoleto. ¿Migrar al modo equipo?
Opciones:
- A) Sí, migrar al modo equipo ahora
- B) No, yo me encargaré
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 vendored a modo equipo" - Dile al usuario: "Hecho. Cada desarrollador ahora ejecuta:
cd ~/.claude/skills/gstack && ./setup --team"
Si B: di "OK, estás por tu cuenta para mantener la copia vendered 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, saltar.
Si SPAWNED_SESSION es "true", 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 resultados mediante salida en prosa.
- Termina con un informe de finalización: qué se envió, decisiones tomadas, cualquier cosa incierta.
Sincronización de Artefactos (inicio de habilidad)
_GSTACK_HOME="${GSTACK_HOME:-$HOME/.gstack}"
# Prefiere el archivo de artefactos v1.27.0.0; recurre al archivo brain para usuarios
# que actualizan a mitad de camino antes de que se ejecute el script de migración.
if [ -f "$HOME/.gstack-artifacts-remote.txt" ]; then
_BRAIN_REMOTE_FILE="$HOME/.gstack-artifacts-remote.txt"
else
_BRAIN_REMOTE_FILE="$HOME/.gstack-brain-remote.txt"
fi
_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
# /sync-gbrain context-load: enseñar al agente a usar gbrain cuando esté disponible.
# Anclaje por worktree: el rediseño post-spike usa `.gbrain-source` de estilo kubectl en la
# raíz de git para delimitar consultas. Busca el anclaje en el worktree (no un archivo
# de estado global) para que abrir el worktree B sin un anclaje no afirme "indexado"
# solo porque el worktree A fue sincronizado. Cadena vacía cuando gbrain no está
# configurado (costo de contexto cero para usuarios que no usan gbrain).
_GBRAIN_CONFIG="$HOME/.gbrain/config.json"
if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_VERSION_OK=$(gbrain --version 2>/dev/null | grep -c '^gbrain ' || echo 0)
if [ "$_GBRAIN_VERSION_OK" -gt 0 ] 2>/dev/null; then
_GBRAIN_PIN_PATH=""
_REPO_TOP=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
if [ -n "$_REPO_TOP" ] && [ -f "$_REPO_TOP/.gbrain-source" ]; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
echo "GBrain configurado. Prefiere `gbrain search`/`gbrain query` sobre Grep para"
echo "preguntas semánticas; usa `gbrain code-def`/`code-refs`/`code-callers` para"
echo "búsqueda de código consciente de símbolos. Consulta \"## Guía de Búsqueda GBrain\" en CLAUDE.md."
echo "Ejecuta /sync-gbrain para actualizar."
else
echo "GBrain configurado pero este worktree aún no está anclado. Ejecuta `sync-gbrain --full`"
echo "antes de confiar en `gbrain search` para preguntas de código en este worktree."
echo "Recurre a Grep hasta que esté anclado."
fi
fi
fi
_BRAIN_SYNC_MODE=$("$_BRAIN_CONFIG_BIN" get artifacts_sy