Arrancar com o LaunchRepo em três passos

A página de arranque do kit cabe num ecrã: clonar, colar um prompt, abrir um link. Este guia percorre os mesmos três passos com um pouco mais de contexto sobre o que acontece por trás de cada um, para saberes o que o teu agente está a fazer e o que verificar no fim. Se preferes ver primeiro o quadro geral, a página como funciona mostra onde estes passos entram no fluxo completo produto → agente → diretórios → tracker.

O que precisas antes de começar

Duas coisas, e provavelmente já tens ambas na tua máquina.

• Python 3.10 ou mais recente em Windows, macOS ou Linux. Os scripts do espaço de trabalho, o tracker e o painel local são Python de biblioteca standard; não há nada para pip install nem passo de build.
• Um agente de código que consiga ler ficheiros e correr comandos — Claude Code, Codex, Cursor ou uma ferramenta comparável. Cada um tem a sua página de configuração neste site, por exemplo Claude Code, Codex e Cursor. O controlo do browser vem mais tarde e não é preciso para os três primeiros passos.

O repositório chega como um convite do GitHub para a conta que indicaste no checkout. Tudo o que se segue assume que o aceitaste.

Passo 1: clonar e abrir

No Windows, usa py -3 em vez de python3 nos comandos abaixo (ou python se esse comando executar Python 3.10 ou mais recente). Mantém o espaço de trabalho numa pasta local privada fora do OneDrive e de outras pastas sincronizadas.

git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo

Abre essa pasta no teu agente como abres qualquer projeto. Ainda nada corre. O checkout que acabaste de fazer é o repositório de entrega: playbooks, templates, scripts e documentação. Os teus produtos, credenciais e registos de submissão não vão viver aqui — é esse o objetivo do passo 2.

Passo 2: colar o prompt de arranque

Cola isto no agente, tal como está:

Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link.

O AGENTS.md é o ficheiro que todo o agente de código com IA lê primeiro; contém o procedimento exato de arranque e as verificações que o agente tem de fazer. Ao segui-lo, o agente:

1. cria um espaço de trabalho privado ao lado do checkout (por defeito, uma pasta irmã) com scripts/init-workspace.py, para que os dados do teu produto nunca fiquem no repositório de entrega partilhado;
2. arranca o painel local a partir desse espaço de trabalho;
3. responde com um link 127.0.0.1.

Se o agente responder com um link, o passo 2 funcionou. Se responder com uma descrição do que faria, pede-lhe que execute mesmo o procedimento — a regra do kit é que uma verificação só está completa depois de observada, não quando existem instruções.

Passo 3: abrir o link

O separador do painel é onde acontece o resto da primeira sessão. A partir daí adicionas o primeiro produto, devolves o prompt de onboarding ao agente, vês que listagens estão live, pendentes, agendadas ou à tua espera, e copias os prompts para execuções futuras. Liga-se apenas a 127.0.0.1 e nunca contacta um diretório; o guia do painel local cobre cada ecrã.

Quando terminares, carrega em Ctrl+C no terminal do agente ou pede-lhe que pare o servidor. O espaço de trabalho e tudo o que lá foi registado ficam no disco.

Fazer à mão

Não precisas do agente para a configuração em si. Os três comandos que o prompt desencadeia são:

python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py

Queres dar uma vista de olhos antes de te comprometeres com um espaço de trabalho? python3 scripts/dashboard.py --demo serve um espaço de trabalho descartável de exemplo com um produto fictício, para poderes percorrer a vista geral, uma página de produto e o catálogo sem tocar nos teus dados.

O que vem a seguir

A primeira sessão propriamente dita — briefing do produto, ligação ao browser, permissões, uma submissão real — é conduzida pelo agente e está descrita no guia de onboarding da primeira sessão. Antes de o agente poder preencher um formulário, também precisas de o ligar ao teu Chrome. Se preferes ler primeiro uma narrativa, o passo a passo com o Claude Code acompanha um lançamento do início ao fim.