Quando invocar esta skill
Mostra quais slots de VERSION estão atualmente reservados por PRs abertos, quais workspaces irmãos do Conductor têm Trabalho em Andamento (WIP) que provavelmente será enviado em breve e qual slot o comando /ship selecionaria em seguida. Nenhuma mutação — apenas um instantâneo. Use quando solicitado a "relatório de aterrissagem", "o que há na fila", "mostre-me 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 "sim" || echo "não")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "desconhecido")
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:-desconhecido}
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"
# Host do Conductor: 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. Bloqueado em !headless para que uma execução de avaliação/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 "sim" || echo "não")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "sim" || echo "não")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Detecção de primeiro projeto: execute o detector SOMENTE na primeira execução da skill
# (ACTIVATED=não, interactive) para que fique fora do caminho quente para todas as execuções seguintes.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "não" ] && [ "$_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 "sim" || echo "não")
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 "sim" || echo "não")
_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:-desconhecido}")'"}' >> ~/.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:-desconhecido}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
_LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
echo "LEARNINGS: $_LEARN_COUNT entradas carregadas"
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="não"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
_HAS_ROUTING="sim"
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="não"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
_VENDORED="sim"
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 para modo de plano para skills como /spec que alteram o comportamento com base no estado do modo de plano.
# Claude Code expõe o modo de plano por meio de lembretes de sistema; detectamos da melhor forma
# a partir de CLAUDE_PLAN_FILE (definido pelo harness quando o modo de plano está ativo) e
# e recorremos a "inactive". Hosts Codex e modo de execução Claude 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 em Modo de Plano
Em 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 da 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 da skill como instruções executáveis, não como referência. Siga-o passo a passo a partir 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 nativo; veja "Formato AskUserQuestion → Resolução da ferramenta") satisfaz o requisito de fim de turno do modo de plano. Se AskUserQuestion não estiver disponível ou uma chamada falhar, siga a alternativa de falha do Formato AskUserQuestion: headless → BLOQUEADO; interactive → a alternativa em 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 ali. Comandos marcados como "EXCEÇÃO DE MODO DE PLANO — SEMPRE EXECUTAR" são executados. Chame ExitPlanMode somente após o fluxo de trabalho da skill ser concluído, ou se o usuário disser para você 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-*. Os 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 atualização inline" (atualização automática se configurada; caso contrário, AskUserQuestion com 4 opções, grave estado de adiamento 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 recursos.
Descoberta de recursos, no máximo um prompt por sessão:
- Ausência de
~/.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. - Ausência de
~/.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 atualização, continue o fluxo de trabalho.
Se WRITING_STYLE_PENDING for sim: pergunte uma vez sobre estilo de escrita:
Os prompts v1 são mais simples: glossários de jargão de primeira utilização, perguntas com resultado enquadrado, prosa mais curta. Manter o padrão ou restaurar o conciso?
Opções:
- A) Manter o novo padrão (recomendado — uma boa escrita ajuda todos)
- B) Restaurar prosa V0 — definir
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 não.
Se LAKE_INTRO for não: diga "gstack segue o princípio Ferver o Oceano — 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 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 não E LAKE_INTRO for sim: pergunte sobre telemetria uma vez via AskUserQuestion:
Ajude o gstack a melhorar. Compartilhe apenas dados de uso: skill, duração, travamentos, ID de dispositivo estável. Nenhum código ou caminho de arquivo. O nome do seu repositório é registrado localmente 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, totalmente 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 sim.
Se PROACTIVE_PROMPTED for não E TEL_PROMPTED for sim: pergunte uma vez:
Deixar o gstack sugerir skills proativamente, como /qa para "isto 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 sim.
Guia de primeira execução (uma vez)
Se ACTIVATED for não (primeira execução da skill nesta máquina) E o preâmbulo imprimiu um valor FIRST_TASK: não vazio que NÃO seja nongit: mostre UMA linha curta e específica do projeto mapeada a partir do token, como um aviso, e CONTINUE com o que o usuário realmente pediu — NÃO pare a tarefa. Mapeie o token: greenfield → "Repositório 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 vê-lo funcionar, ou /investigate se algo estiver errado." branch_ahead → "Trabalho não enviado neste branch — /review e depois /ship." dirty_default → "Alterações não confirmadas — /review antes de confirmar." 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 não mas FIRST_TASK: estiver vazio ou for nongit (headless, não-git, ou nada acionável): não mostre nada, apenas execute touch ~/.gstack/.activated 2>/dev/null || true.
Senão, se ACTIVATED for sim E FIRST_LOOP_SHOWN for não: 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 e 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 sim.
Se HAS_ROUTING for não E ROUTING_DECLINED for false E PROACTIVE_PROMPTED for sim:
Verifique se existe um arquivo CLAUDE.md na raiz do projeto. Se não existir, crie-o.
Use AskUserQuestion:
O gstack funciona melhor quando o CLAUDE.md do seu projeto inclui regras de roteamento de skill.
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:
## Skill routing
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 principais de roteamento:
- 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 completo de revisão → invocar /autoplan
- Bugs/erros → invocar /investigate
- Funcionalidade funcional? → invocar /qa
- Pronto para enviar? → invocar /ship
Se não tiver certeza, pergunte ao usuário a qual categoria sua solicitação pertence.
Sempre execute:
touch ~/.gstack/.routing-declined
Se B: execute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true
Pule esta seção se HAS_ROUTING for sim ou ROUTING_DECLINED for true.
Execução da Skill
Passo 0: Executar o Preâmbulo
Execute o bloco ## Preamble (run first) acima.
Use o valor _QUESTION_TUNING para ajustar o estilo da pergunta:
- Se
true: perguntas curtas e diretas ("Qual branch?"). - Se
false(padrão): perguntas mais longas com contexto.
Passo 1: Obter Estado da Fila
~/.claude/skills/gstack/bin/gstack-landscape
Passo 2: Apresentar Painel
Mostre ao usuário uma análise dos dados retornados. Estruture-a como:
- Slots VERSION reservados: liste PRs abertos e o slot que cada um reivindica.
- Workspaces com WIP: liste workspaces irmãos que têm trabalho não enviado.
- Próximo slot /ship: mostre qual slot será selecionado em seguida.
- Snapshot somente leitura: enfatize que nenhuma mutação foi realizada.
Apresente em formato de painel legível, usando texto simples e, se aplicável, formatação para destaque.
Passo 3: Oferta de Ações
Pergunte naturalmente (em prosa) como o usuário gostaria de proceder, sem invocar nenhuma ferramenta AskUserQuestion. Use o valor _EXPLAIN_LEVEL para ajustar o estilo da resposta conforme descrito acima.