Pular para o conteúdo

Antes de a IA dizer “pronto”, faça ela testar sozinha

O pstack é um conjunto de regras de trabalho, gratuito e de código aberto, que você instala na sua IA. Com ele, a IA primeiro confirma o que você quer e depois muda só o que precisa mudar. Você não precisa saber programar.

Para iniciantes: três lições, 20 minutos.

Já aconteceu com você?

  • A IA diz “pronto!”. Você abre e o botão não faz nada.
  • Você diz “continua quebrado”. Ela responde “desculpe, agora está corrigido”. E dá o mesmo resultado, de novo e de novo.
  • Você queria uma mudança pequena, e ela mudou um monte de coisas que você nem pediu.

O que muda depois de instalar

QuandoA IA de sempreCom pstack
Antes de começarComeça sem confirmar o que você querPrimeiro repete seu objetivo com as palavras dela, para você corrigir na hora
Enquanto muda as coisasMuda algo num lugar que parece mais ou menos certoPrimeiro descobre qual é o problema e depois muda o mínimo possível
Quando diz que terminou“Agora deve estar funcionando”Diz o que realmente verificou e o que viu, e avisa com clareza o que não conseguiu verificar

Para quem está começando, bastam três lições

Leia na ordem, 20 minutos no total. Depois dessas três, você já consegue usar. O resto do site é para consultar depois.

  1. O que ele faz por você3 minutos · O que é o pstack, do que você precisa e quanto custa
  2. Instale5 minutos · Digite duas linhas no Claude Code e escolha uma opção
  3. Use pela primeira vez10 minutos · Faça uma pequena página web com uma mensagem em três partes

É para você?

Sim, se

  • Você já fez páginas pequenas, extensões ou ferramentas com IA e se decepcionou com um “pronto” que não estava pronto
  • Você já tem o Claude Code (ou Cursor ou Codex) e consegue conversar com a IA nele
  • Você prefere que fique certo a que fique rápido

Ainda não, se

  • Você ainda não usou uma ferramenta como o Claude Code: instale primeiro com o guia oficial e volte quando já conseguir conversar
  • É uma mudança mínima, como um erro de digitação ou uma cor: peça direto para a IA
  • Você só quer o mais rápido e barato: o pstack verifica mais, então é mais lento e gasta mais do seu plano

Se você programa

O pstack é o pacote de skills que poteto (do time principal do React, trabalha no Cursor) usa todo dia no próprio código: 34 skills, 23 playbooks e 24 princípios de engenharia. Abaixo estão os quatro passos que ele segue em cada tarefa e o guia completo de 9 passos.

Por enquanto, o guia completo está em inglês (e em chinês).

Você diz uma frase

O objetivo e como você vai saber que está pronto. Por exemplo: “primeiro reproduza, depois corrija, depois verifique”.

/pstack:poteto-mode escolhe um playbook

Escolhe um dos 23 playbooks e copia os passos dele, do jeito que estão, para a lista de tarefas.

As skills rodam passo a passo

/pstack:how para ler código, /pstack:architect para decidir um design, /pstack:interrogate para achar falhas; IAs ajudantes quando há muito trabalho.

Verifica antes de entregar

Saída real de comandos, capturas de tela, o antes e o depois. Se algo não dá para verificar, ele avisa.

  1. What pstack is5-minute read · What it's for, what it costs, what you need
  2. Install pstack5 minutes · One way each for Claude Code, Cursor and Codex
  3. Pick models and budget (optional)10 minutes · Works without it; read this to save money or switch models
  4. Your first task15 minutes · Say it in one message, then check its restatement and results
  5. Understand before you change15 minutes · Have the AI explain how the code works before deciding to change it
  6. Design, build, clean up20 minutes · Settle the plan for big changes, have other models pick holes, cut what isn't needed
  7. Verify and ship20 minutes · Make sure it really works, then hand it in for merging
  8. Let it run on its own15 minutes · Brief it before bed, read its log in the morning
  9. Once you're comfortableAs needed · Pull it back in one line; stop the same mistake from happening twice

Perguntas e conversa

This airali copy is based on the original open-source guide. Visit the source repository for its history and updates.

Antes de perguntar, veja as perguntas frequentes (em inglês): muitas respostas já estão lá.

Antes de mandar capturas de tela, esconda chaves de API, código da sua empresa e dados das suas contas.

Um guia não oficial de pstack para iniciantes, não a documentação oficial. O pstack é feito por poteto (licença MIT); o repositório oficial é a referência para comandos e comportamento. O código deste guia e os comentários ficam no GitHub.

Hosted by airali. Adapted from Xiaoxiaodong's MIT-licensed guide.