IA by DNACX

#9 no GitHub · Pacotes prontos

Como usar o gstack no Claude Code: passo a passo

O gstack transforma o Claude Code numa equipe virtual com comandos de barra: um sócio que questiona o produto, um gerente de engenharia, um designer, um revisor de código, um responsável por testes que abre um navegador de verdade e um engenheiro de lançamento. Tudo em Markdown, gratuito, licença MIT.

Para quem
O README cita fundadores e CEOs, quem está usando o Claude Code pela primeira vez (papéis estruturados em vez de uma tela em branco) e líderes técnicos.
Estrelas (02/11/2026)
138.679, #9 no ranking
Licença
MIT
Repositório
garrytan/gstack

Passo a passo

Antes de começar: Claude Code; Git; Bun versão 1.4.2 ou mais nova (o setup recusa versões abaixo de 1.3.3); Node.js, no caso do Windows; macOS ou Linux têm suporte completo. No Windows funciona pelo Git Bash ou WSL, com suporte mínimo.

  1. Instale o Bun e confira o Git

    O gstack precisa do Bun e do Git no computador. O README não traz o comando para instalar o Bun e aponta o site bun.sh. Sem eles, o setup não completa.

  2. Cole o pedido de instalação no Claude Code

    Abra o Claude Code e cole o texto abaixo, como está. O Claude baixa o gstack, roda o setup e acrescenta uma seção ao CLAUDE.md. O README estima cerca de 30 segundos.

    Comando
    Install gstack: run git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing and never use mcp\_\_claude-in-chrome\_\_\* tools. Claude Code lists the installed skills itself, so the section needs no skill list. Then ask the user if they also want to add gstack to the current project so teammates get it.

  3. Reinicie o Claude Code se as habilidades não aparecerem

    Se o Claude disser que não vê as habilidades, confira se a pasta existe e reinicie o Claude Code. Ele lista sozinho todas as habilidades instaladas.

    Comando
    ls ~/.claude/skills

  4. Comece pelo /office-hours

    Digite o comando e descreva o que você está construindo. Ele questiona o seu enquadramento e escreve um documento de desenho que os outros comandos leem depois.

    Comando
    /office-hours

Primeiro teste

Numa sessão do Claude com a skill instalada, cole:

Primeiro teste
/office-hours

O README diz que o comando faz seis perguntas que reenquadram o produto, desafia suas premissas, propõe alternativas de implementação e escreve um documento de desenho que alimenta os comandos seguintes.

Cuidados

  • O pedido de instalação baixa o código do GitHub e executa o script ./setup no seu computador. Esse setup monta binários e um navegador próprio de testes na sua máquina.
  • O setup registra hooks no Claude Code. Os hooks também servem de trava: o README classifica as habilidades de segurança como enforced no Claude Code (os hooks bloqueiam).
  • O pedido de instalação mexe no CLAUDE.md: acrescenta uma seção mandando usar o /browse do gstack para navegar na web e nunca usar as ferramentas mcp__claude-in-chrome__*.
  • Há verificação automática de atualização no início de cada sessão do Claude Code. O README diz que é limitada a uma vez por hora e silenciosa. Dá para desligar com gstack-config set update_check false.
  • A telemetria vem desligada e é perguntada uma vez. Já as revisões externas vêm ligadas por padrão: enviam código para o Codex ou para o Claude Code, com o seu próprio login, e a primeira vez mostra um aviso. Desligar: gstack-config set codex_reviews disabled.
  • O passo 2 do README (modo equipe) altera o repositório e faz um commit. Ele é indicado para repositórios compartilhados, por isso não entrou no caminho feliz.
  • No Windows com o Smart App Control ligado, os binários compilados (sem assinatura) podem ser bloqueados. O README sugere WSL ou desligar o Smart App Control.
  • O /qa abre um navegador de verdade. O /cso só executa testes em ambiente isolado se houver Docker; sem Docker, faz apenas a análise estática. O README sugere parar depois dos três primeiros comandos para ver se o gstack serve para você.

Como desfazer

O README manda para o arquivo docs/uninstall.md. Lá, a opção 1 é rodar o script de desinstalação que acompanha o gstack (caminho ~/.claude/skills/gstack/bin/gstack-uninstall), que remove habilidades, estado global e hooks. Esse texto foi lido em raw.githubusercontent.com em 02/11/2026. O comando não está no README principal, por isso aparece como texto e não como comando.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README não diz se a seção do CLAUDE.md vai para o arquivo global ou para o do projeto atual.
  • O README não traz o comando para instalar o Bun, só o link do site.
  • O texto de instalação está copiado com a formatação Markdown do README (asteriscos, crases e barras invertidas antes dos sublinhados). Na página renderizada do GitHub essas marcas não aparecem, mas mantive o texto cru para a conferência literal.
  • O comando de desinstalação vem de docs/uninstall.md, lido em 02/11/2026, e não do README principal.
  • Não está confirmado onde exatamente o /office-hours grava o documento de desenho. O README diz apenas que escreve um design doc que as outras habilidades leem.
  • O README não diz quanto custa em uso do plano rodar o /qa ou o /ship.

Dúvidas

Preciso do passo 2, o modo equipe?

O README o recomenda para repositórios compartilhados: ele prepara o repositório para os colegas receberem o gstack automaticamente e faz um commit. Para uso individual, o passo 1 já instala.

O Claude diz que não vê as habilidades. E agora?

Confira se estão instaladas com ls ~/.claude/skills e reinicie o Claude Code. Se continuar, o README indica rodar o diagnóstico ~/.claude/skills/gstack/bin/gstack-doctor, que mostra uma linha por verificação e o comando que conserta cada falha.

Funciona no Windows?

O README diz que funciona no Windows 11 via Git Bash ou WSL, com suporte mínimo. Precisa de Bun e de Node.js. No PowerShell, o .\setup.ps1 confere se Git, Bun e Node.js estão no PATH e mostra o comando winget do que faltar.

A DNACX já usou o gstack?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próxima da lista

← #8 Graphify · #10 Caveman →

Ver as 15 skills

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de garrytan/gstack, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.