/landing-report — Painel da Fila de Versão
Preâmbulo (execute 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"
_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 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="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
Operações Seguras em Modo Plano
No modo plano, são permitidas porque informam o plano: $B, $D, codex exec/codex review, gravações em ~/.gstack/, gravações no arquivo do plano e open para artefatos gerados.
Invocação de Skill Durante o Modo Plano
Se o usuário invocar uma skill no modo plano, a skill tem precedência sobre o comportamento genérico do modo plano. Trate o arquivo da skill como instruções executáveis, não como referência. Siga-o passo a passo começando do Passo 0; a primeira AskUserQuestion é o fluxo de trabalho entrando no modo plano, não uma violação dele. AskUserQuestion satisfaz o requisito de fim de turno do modo plano. Em um ponto STOP, pare imediatamente. Não continue o fluxo de trabalho nem chame ExitPlanMode ali. Comandos marcados como "EXCEÇÃO DE MODO PLANO — SEMPRE EXECUTE" são executados. Chame ExitPlanMode somente 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 plano.
Se PROACTIVE for "false", não invoque automaticamente nem sugira skills proativamente. Se uma skill parecer útil, pergunte: "Acho que /skill-name pode ajudar aqui — quer executá-la?"
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" (auto-atualizar se configurado, caso contrário AskUserQuestion com 4 opções, escreva estado de soneca se recusado).
Se a saída mostrar JUST_UPGRADED <from> <to>: imprima "Executando gstack v{to} (recém atualizado!)". 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 commits automáticos de checkpoint contínuo. Se aceito, execute~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Sempre crie o 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 crie o marcador.
Após prompts de atualização, 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ários de jargão no primeiro uso, perguntas com resultado definido, prosa mais curta. Manter o padrão ou restaurar o estilo conciso?
Opções:
- A) Manter o novo padrão (recomendado — uma boa escrita ajuda a 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 no.
Se LAKE_INTRO for no: diga "gstack segue o princípio Ferver o Lago — faça a coisa completa quando o custo marginal da IA é 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 no E LAKE_INTRO for yes: pergunte sobre telemetria uma vez via AskUserQuestion:
Ajude o gstack a melhorar. Compartilhe apenas dados de uso: habilidade, duração, falhas, ID de dispositivo estável. Sem código, caminhos de arquivo ou nomes de repositório.
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 o seguinte:
O modo anônimo envia apenas uso agregado, sem ID único.
Opções:
- A) Sim, 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 yes.
Se PROACTIVE_PROMPTED for no E TEL_PROMPTED for yes: pergunte uma vez:
Deixar o gstack sugerir 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.
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:
O 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, vou invocar 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 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
- QA/teste de comportamento do site → invocar /qa ou /qa-only
- Revisão de código/verificação de diff → invocar /review
- Polimento visual → invocar /design-review
- Envio/implantação/PR → invocar /ship ou /land-and-deploy
- Salvar progresso → invocar /context-save
- Retomar contexto → invocar /context-restore
Em seguida, confirme a alteração: git add CLAUDE.md && git commit -m "chore: adicionar regras de roteamento de skills gstack ao CLAUDE.md"
Se B: execute ~/.claude/skills/gstack/bin/gstack-config set routing_declined true e diga que eles podem reativar com gstack-config set routing_declined false.
Isso só acontece uma vez por projeto. Pule se HAS_ROUTING for yes ou ROUTING_DECLINED for true.
Se VENDORED_GSTACK for yes, avise uma vez via AskUserQuestion a menos que ~/.gstack/.vendoring-warned-$SLUG exista:
Este projeto tem o gstack vendido em
.claude/skills/gstack/. A venda é descontinuada. Migrar para o modo de equipe?
Opções:
- A) Sim, migrar para o modo de equipe agora
- B) Não, eu mesmo cuidarei disso
Se A:
- Execute
git rm -r .claude/skills/gstack/ - Execute
echo '.claude/skills/gstack/' >> .gitignore - Execute
~/.claude/skills/gstack/bin/gstack-team-init required(ouoptional) - Execute
git add .claude/ .gitignore CLAUDE.md && git commit -m "chore: migrar gstack de vendido para modo de equipe" - Diga ao usuário: "Pronto. Cada desenvolvedor agora executa:
cd ~/.claude/skills/gstack && ./setup --team"
Se B: diga "OK, você é por sua conta para manter a cópia vendida atualizada."
Sempre execute (independentemente da escolha):
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
Se o marcador existir, pule.
Se SPAWNED_SESSION for "true", você está executando dentro de uma sessão gerada por um orquestrador de IA (por exemplo, OpenClaw). Em sessões geradas:
- NÃO use AskUserQuestion para prompts interativos. Escolha automaticamente a opção recomendada.
- NÃO execute verificações de atualização, prompts de telemetria, injeção de roteamento ou introdução do lago.
- Concentre-se em concluir a tarefa e relatar os resultados por meio de saída em prosa.
- Termine com um relatório de conclusão: o que foi enviado, decisões tomadas, qualquer coisa incerta.
Formato AskUserQuestion
Cada AskUserQuestion é um resumo de decisão e deve ser enviado como tool_use, não como prosa.
D<N> — <título da pergunta em uma linha>
Projeto/ramo/tarefa: <1 frase curta de contextualização usando _BRANCH>
ELI10: <inglês simples que um adolescente de 16 anos entenderia, 2-4 frases, nomeie os riscos>
Riscos se escolhermos errado: <uma frase sobre o que quebra, o que o usuário vê, o que se perde>
Recomendação: <escolha> porque <razão em uma linha>
Completude: A=X/10, B=Y/10 (ou: Nota: as opções diferem em tipo, não em cobertura — sem pontuação de completude)
Prós / contras:
A) <rótulo da opção> (recomendado)
✅ <pró — concreto, observável, ≥40 caracteres>
❌ <contra — honesto, ≥40 caracteres>
B) <rótulo da opção>
✅ <pró>
❌ <contra>
Saldo: <síntese em uma linha do que você está realmente trocando>
Numeração D: a primeira pergunta em uma invocação de skill é D1; incremente você mesmo. Esta é uma instrução de nível de modelo, não um contador de tempo de execução.
ELI10 está sempre presente, em inglês simples, sem nomes de funções. A Recomendação está SEMPRE presente. Mantenha o rótulo (recomendado); AUTO_DECIDE depende dele.
Completude: use Completude: N/10 apenas quando as opções diferem em cobertura. 10 = completo, 7 = caminho feliz, 3 = atalho. Se as opções diferem em tipo, escreva: Nota: as opções diferem em tipo, não em cobertura — sem pontuação de completude.
Prós / contras: use ✅ e ❌. Mínimo de 2 prós e 1 contra por opção quando a escolha é real; Mínimo de 40 caracteres por marcador. Escape de parada forçada para confirmações unidirecionais/destrutivas: ✅ Sem contras — esta é uma escolha de parada forçada.
Postura neutra: Recomendação: <padrão> — esta é uma questão de gosto, sem preferência forte de qualquer lado; (recomendado) PERMANECE na opção padrão para AUTO_DECIDE.
Escalas de esforço em ambos: quando uma opção envolve esforço, rotule o tempo da equipe humana e do CC+gstack, por exemplo, (humano: ~2 dias / CC: ~15 min). Torna a compressão de IA visível no momento da decisão.
Linha de saldo fecha a troca. Instruções por skill podem adicionar regras mais rigorosas.
Auto-verificação antes de emitir
Antes de chamar AskUserQuestion, verifique:
- Cabeçalho D presente
- Parágrafo ELI10 presente (linha de riscos também)
- Linha de recomendação presente com motivo concreto
- Pontuação de completude (cobertura) OU nota de tipo presente (tipo)
- Cada opção tem ≥2 ✅ e ≥1 ❌, cada ≥40 caracteres (ou escape de parada forçada)