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
| Quando | A IA de sempre | Com pstack |
|---|---|---|
| Antes de começar | Começa sem confirmar o que você quer | Primeiro repete seu objetivo com as palavras dela, para você corrigir na hora |
| Enquanto muda as coisas | Muda algo num lugar que parece mais ou menos certo | Primeiro 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.
- O que ele faz por você3 minutos · O que é o pstack, do que você precisa e quanto custa
- Instale5 minutos · Digite duas linhas no Claude Code e escolha uma opção
- 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.
- What pstack is5-minute read · What it's for, what it costs, what you need
- Install pstack5 minutes · One way each for Claude Code, Cursor and Codex
- Pick models and budget (optional)10 minutes · Works without it; read this to save money or switch models
- Your first task15 minutes · Say it in one message, then check its restatement and results
- Understand before you change15 minutes · Have the AI explain how the code works before deciding to change it
- Design, build, clean up20 minutes · Settle the plan for big changes, have other models pick holes, cut what isn't needed
- Verify and ship20 minutes · Make sure it really works, then hand it in for merging
- Let it run on its own15 minutes · Brief it before bed, read its log in the morning
- 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.