Quando invocar esta skill
Mostra quais slots de VERSION estão atualmente reivindicados por PRs abertos, quais workspaces do Conductor (sibling) têm trabalho em andamento (WIP) com alta probabilidade de serem enviados (ship) em breve, e que slot /ship selecionaria a seguir. Sem mutações — apenas um instantâneo. Use quando perguntarem "relatório de aterrissagem", "o que está na fila", "mostre-me os PRs abertos" ou "qual versão devo reivindicar em seguida".
/landing-report — Painel de Fila de Versão
Preâmbulo (executar primeiro)
_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"
_SESSION_KIND=$(~/.claude/skills/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"
# Conductor host: AskUserQuestion não é confiável aqui (nativo desabilitado, variante
# MCP instável), então as skills renderizam decisões como prosa em vez de chamar a
# ferramenta. Protegido por !headless para que uma execução eval/CI DENTRO do Conductor (GSTACK_HEADLESS)
# ainda BLOQUEIE em vez de renderizar prosa para ninguém.
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"
# Detecção de projeto na primeira execução: executa o detector APENAS na primeira execução da skill
# (ACTIVATED=no, interactive) para que fique fora do caminho crítico para todas as execuções posteriores.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
_FIRST_TASK=$(~/.claude/skills/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=$(~/.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":"'$(_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 "~/.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"
# Dica de modo de plano para skills como /spec que ramificam o comportamento com base no estado do modo de plano.
# Claude Code expõe o modo de plano através de lembretes do sistema; detectamos com melhor esforço
# a partir de CLAUDE_PLAN_FILE (definido pelo harness quando o modo de plano está ativo) e
# recorremos a "inactive". Hosts Codex e modo de execução Claude ambos terminam como
# inactive, que é o padrão seguro (padrão para pipeline de arquivo+execução).
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
Operações Seguras no Modo de Plano
No modo de plano, permitidas porque informam o plano: $B, $D, codex exec/codex review, gravações em ~/.gstack/, gravações no arquivo de plano, e open para artefatos gerados.
Invocação de Skill Durante o Modo de Plano
Se o usuário invocar uma skill no modo de plano, a skill tem precedência sobre o comportamento genérico do modo de plano. Trate o arquivo de skill como instruções executáveis, não como referência. Siga-o passo a passo começando do Passo 0; o primeiro AskUserQuestion é o fluxo de trabalho entrando no modo de plano, não uma violação dele. AskUserQuestion (qualquer variante — mcp__*__AskUserQuestion ou nativa; veja "Formato AskUserQuestion → Resolução de ferramenta") satisfaz o requisito de fim de turno do modo de plano. Se AskUserQuestion não estiver disponível ou uma chamada falhar, siga o fallback de falha do Formato AskUserQuestion: headless → BLOQUEADO; interactive → o fallback de prosa (também satisfaz o fim de turno). Em um ponto de PARADA, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode lá. Comandos marcados como "EXCEÇÃO DE MODO DE PLANO — SEMPRE EXECUTAR" executam. Chame ExitPlanMode apenas após o fluxo de trabalho da skill ser concluído, ou se o usuário disser para cancelar a skill ou sair do modo de plano.
Se PROACTIVE for "false", não invoque automaticamente nem sugira skills proativamente. Se uma skill parecer útil, pergunte: "Acho que /skillname pode ajudar aqui — quer que eu execute?"
Se SKILL_PREFIX for "true", sugira/invoque nomes /gstack-*. Caminhos de disco permanecem ~/.claude/skills/gstack/[skill-name]/SKILL.md.
Se a saída mostrar UPGRADE_AVAILABLE <old> <new>: leia ~/.claude/skills/gstack/gstack-upgrade/SKILL.md e siga o "fluxo de upgrade inline" (auto-upgrade se configurado, caso contrário AskUserQuestion com 4 opções, escreve estado de soneca se recusado).
Se a saída mostrar JUST_UPGRADED <from> <to>: imprima "Executando gstack v{to} (acabou de atualizar!)". Se SPAWNED_SESSION for true, pule a descoberta de funcionalidades.
Descoberta de funcionalidades, no máximo um prompt por sessão:
- Faltando
~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para auto-commits de checkpoint Contínuo. Se aceito, execute~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Sempre toque no marcador. - Faltando
~/.claude/skills/gstack/.feature-prompted-model-overlay: informe "Sobreposições de modelo estão ativas. MODEL_OVERLAY mostra o patch." Sempre toque no marcador.
Após prompts de upgrade, continue o fluxo de trabalho.
Se WRITING_STYLE_PENDING for yes: pergunte uma vez sobre o estilo de escrita:
Os prompts v1 são mais simples: glossário de jargão no primeiro uso, perguntas com resultados enquadrados, prosa mais curta. Manter o padrão ou restaurar o conciso?
Opções:
- A) Manter o novo padrão (recomendado — boa escrita ajuda todos)
- B) Restaurar prosa V0 — defina
explain_level: terse
Se A: deixe explain_level não definido (padrão é default).
Se B: execute ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.
Sempre execute (independentemente da escolha):
rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted
Pule se WRITING_STYLE_PENDING for no.
Se LAKE_INTRO for no: diga "gstack segue o princípio Boil the Ocean — faça a coisa completa quando a IA torna o custo marginal quase zero. Leia mais: https://garryslist.org/posts/boil-the-ocean" Ofereça-se para abrir:
open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen
Execute open apenas se sim. Sempre execute touch.
Se TEL_PROMPTED for no E LAKE_INTRO for yes: pergunte telemetria uma vez via AskUserQuestion:
Ajude o gstack a melhorar. Compartilhe apenas dados de uso: skill, duração, falhas, ID de dispositivo estável. Sem código ou caminhos de arquivo. O nome do seu repositório é gravado localmente apenas e removido antes de qualquer upload.
Opções:
- A) Ajude o gstack a melhorar! (recomendado)
- B) Não, obrigado
Se A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry community
Se B: pergunte acompanhamento:
Modo anônimo envia apenas uso agregado, sem ID único.
Opções:
- A) Claro, anônimo está bem
- B) Não, obrigado, completamente desligado
Se B→A: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous
Se B→B: execute ~/.claude/skills/gstack/bin/gstack-config set telemetry off
Sempre execute:
touch ~/.gstack/.telemetry-prompted
Pule se TEL_PROMPTED for yes.
Se PROACTIVE_PROMPTED for no E TEL_PROMPTED for yes: pergunte uma vez:
Permita que o gstack sugira skills proativamente, como /qa para "isso funciona?" ou /investigate para bugs?
Opções:
- A) Manter ativado (recomendado)
- B) Desligar — vou digitar /comandos eu mesmo
Se A: execute ~/.claude/skills/gstack/bin/gstack-config set proactive true
Se B: execute ~/.claude/skills/gstack/bin/gstack-config set proactive false
Sempre execute:
touch ~/.gstack/.proactive-prompted
Pule se PROACTIVE_PROMPTED for yes.
Orientação de primeira execução (uma vez)
Se ACTIVATED for no (primeira execução da skill nesta máquina) E o preâmbulo imprimiu um valor FIRST_TASK: não vazio que NÃO é nongit: mostre UMA linha curta e específica do projeto mapeada a partir do token, como um aviso, então CONTINUE com o que o usuário realmente pediu — NÃO pare a tarefa dele. Mapeie o token: greenfield → "Repo novo — modele-o primeiro com /spec ou /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Há código aqui — /qa para ver funcionar, ou /investigate se algo estiver errado." branch_ahead → "Trabalho não enviado neste branch — /review depois /ship." dirty_default → "Alterações não commitadas — /review antes de commitar." clean_default → "Escolha um: /spec, /investigate, ou /qa." Em seguida, substitua o token que você viu por TASK_TOKEN e execute (melhor esforço), e marque como ativado:
~/.claude/skills/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
Se ACTIVATED for no mas FIRST_TASK: estiver vazio ou for nongit (headless, non-git, ou nada acionável): não mostre nada, apenas execute touch ~/.gstack/.activated 2>/dev/null || true.
Senão, se ACTIVATED for yes E FIRST_LOOP_SHOWN for no: diga uma vez como aviso (então continue):
Dica: o gstack compensa quando você completa um loop — planejar → revisar → enviar. Um primeiro loop comum:
/office-hoursou/specpara modelar,/plan-eng-reviewpara travar, depois/ship.
Em seguida, execute touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.
Pule esta seção se ACTIVATED e FIRST_LOOP_SHOWN forem ambos yes.
Se HAS_ROUTING for no E ROUTING_DECLINED for false E PROACTIVE_PROMPTED for yes:
Verifique se um arquivo CLAUDE.md existe na raiz do projeto. Se não existir, crie-o.
Use AskUserQuestion:
gstack funciona melhor quando o CLAUDE.md do seu projeto inclui regras de roteamento de skills.
Opções:
- A) Adicionar regras de roteamento ao CLAUDE.md (recomendado)
- B) Não, obrigado, invocarei skills manualmente
Se A: Anexe esta seção ao final do CLAUDE.md:
## Roteamento de skills
Quando a solicitação do usuário corresponder a uma skill disponível, invoque-a através da ferramenta Skill. Em caso de dúvida, invoque a skill.
Regras de roteamento principais:
- Ideias de produto/brainstorming → invocar /office-hours
- Estratégia/escopo → invocar /plan-ceo-review
- Arquitetura → invocar /plan-eng-review
- Sistema de design/revisão de plano → invocar /design-consultation ou /plan-design-review
- Pipeline de revisão completo → invocar /autoplan
- Bugs/erros → invocar /investigate
- Qualidade/correção → invocar /qa
- Envio de trabalho/liberação → invocar /ship
- Configuração do projeto → invocar /onboard
- Mudanças pequenas e rápidas → invocar /spin
- Atualizações de dependências → invocar /deps
Em seguida, execute touch ~/.gstack/.routing-declined 2>/dev/null || true (apenas para fluxo).
Se B: Execute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true e touch ~/.gstack/.routing-declined 2>/dev/null || true.