K
KIT PILOTO AUTOMÁTICOAtualização v31
Seus dados são usados apenas para liberar o acesso à atualização e, caso você autorize, para o contato da nossa equipe. Nada é compartilhado com terceiros.
Seus dados são usados apenas para liberar o acesso à atualização e, caso você autorize, para o contato da nossa equipe. Nada é compartilhado com terceiros.
Passo a passo do KPA V31 — leia com atenção pra não fazer errado.
Existem 2 formas de instalar. Escolha uma.
Você vai instalar e deixar rodando o Kit Piloto Automático (KPA) V31 neste computador, para uma pessoa que não entende de programação. Fale em português simples, explique em uma frase o que vai fazer antes de cada passo, e não me peça para digitar comando nenhum: você executa tudo. Se um passo falhar, pare, me mostre a mensagem de erro de verdade e diga em uma frase o motivo provável e o que fazer. Duas regras que não podem ser quebradas em nenhum momento: - NÃO sobrescreva nem apague nada que já exista. Tudo que você trouxer de outro lugar entra em pasta nova, ao lado, nunca por cima. - NÃO copie, mostre nem mova segredos: arquivos .env, senhas, tokens, chaves de API, credenciais. Se encontrar, ignore e siga em frente. Contexto: a pasta que você está enxergando é o kit V31. Em algum lugar dela existe uma subpasta chamada v31, com um package.json que tem um script chamado kpa. É de dentro dessa pasta v31 que tudo roda. Faça nesta ordem: 1. Encontre a pasta v31 (a que tem package.json com o script kpa) e trabalhe a partir dela. 2. Verifique o Node.js: rode node --version. Precisa ser 20 ou maior (ideal 24 LTS). Se não existir, ou for menor que 20, PARE e me diga: "Baixe o instalador LTS em https://nodejs.org, instale, feche e abra este aplicativo de novo, e me mande este prompt outra vez." Não tente instalar o Node sozinho. 3. Só no Windows: veja o tamanho do caminho completo da pasta v31. Se passar de ~150 caracteres, PARE e me peça para mover a pasta do kit para algo curto como C:\KPA e recomeçar. Caminho longo trava a instalação no Windows. 4. Aproveite um kit antigo, SE existir (se não, pule este passo e siga). Procure APENAS na Área de Trabalho, Documentos e Downloads por uma pasta que seja um Kit Piloto Automático anterior — o sinal é ter 00_INDEX.md na raiz junto com pastas como 00_OS e 05_WORKSPACE. Não vasculhe o disco inteiro; se não achar rápido, siga sem. Ignore a própria pasta do V31. Se achar, traga só o que é DADO DA PESSOA para dentro de v31/workspace/importado-do-v30/ (crie a subpasta): o conteúdo de 05_WORKSPACE/, 06_OUTPUTS/, 07_LOGS/, e agentes/skills/templates que a pessoa tenha criado. Copie, não mova. Não traga node_modules, builds, nem os arquivos-padrão do sistema (já vêm no V31). Não traga segredo. Ao terminar, me diga o que trouxe e de onde, e avise que fica guardado em importado-do-v30/ para eu pedir ao KPA usar — você NÃO vai mexer nos arquivos do V31 com base nele agora. 5. Instale as dependências: corepack pnpm install --frozen-lockfile. Se corepack não existir, use pnpm install --frozen-lockfile; se também não, npx --yes pnpm@9.15.9 install --frozen-lockfile. Leva alguns minutos e precisa de internet. Se falhar por rede, é firewall/antivírus — sugira outra rede. 6. Instale os agentes e skills: corepack pnpm kpa install . --target all. Coloca as 7 skills no Claude Code e no Codex e cria a workspace. Me diga quantas skills foram instaladas. 7. Rode o diagnóstico: corepack pnpm kpa doctor. Traduza o resultado: o que passou e o que ficou só como aviso (aviso não é erro). 8. Deixe rodando: corepack pnpm kpa start em segundo plano. Na PRIMEIRA vez o ambiente demora alguns minutos preparando um banco local — é normal. Verifique http://127.0.0.1:4310/api/v1/health até responder "ok", aí abra http://127.0.0.1:4310 e me diga que a primeira tela é "Configurar meu negócio". 9. Se não conseguir manter servidor em segundo plano, me diga para dar dois cliques em ABRIR-PRIMEIRO na raiz do kit (.cmd no Windows, .command no Mac). Uma janela preta abre, demora na primeira vez, e o navegador abre sozinho. No fim, me diga em uma frase o que foi feito e qual o próximo passo para eu usar o kit.