Como fazer este workshop no seu próprio ritmo

Este workshop foi projetado para uma sessão em sala com instrutor, mas tudo que você precisa para concluí-lo sozinho já está neste guia. Se estiver seguindo o repositório por conta própria — ou se alguém o compartilhou com você depois do evento —, esta página é seu mapa.

Escolha macOS ou Windows no cabeçalho da página antes da configuração. No Windows, os participantes executam todos os comandos do workshop no Ubuntu com WSL 2; o PowerShell aparece apenas nos blocos de inicialização e recuperação do Windows, identificados explicitamente.

O que muda sem um instrutor

Resposta curta: nada nos módulos 00 a 07. O percurso principal é totalmente autoguiado. Você cria seu próprio período de avaliação no ClickHouse Cloud, seu próprio Postgres gerenciado pelo ClickHouse usando clickhousectl (módulo 03) e suas próprias chaves de API — não há nenhum recurso compartilhado do qual você dependa. Os módulos 04 a 09 são idênticos.

Normalmente, um instrutor oferece duas coisas, e cada uma tem uma alternativa de autoatendimento incorporada a este material:

• A clínica de configuração com equipe de apoio (módulo 00) é substituída por ./preflight.sh em ClickHouse_Demos/workshops/build_workshop/app, que verifica tudo que costuma impedir a inicialização ao vivo, e pela página Solução de problemas, que lista todas as falhas observadas nos testes e a correção exata de cada uma.
• Ajuda ao vivo para sair de bloqueios durante um módulo é substituída por duas coisas: seu agente de programação atuando como instrutor (abaixo) e a trilha do instrutor como gabarito (abaixo).

A trilha do instrutor é seu gabarito

A trilha do instrutor está publicada neste mesmo guia. Cada módulo tem uma página correspondente para o instrutor com o cronograma, as falhas que realmente ocorrem e como desbloqueá-las, além das etapas de redefinição para voltar a um estado conhecido e funcional. Quando um módulo não se comportar como a etapa de verificação prevê, abra a página correspondente do instrutor — ela foi escrita exatamente para esse momento.

Seu agente de programação é seu instrutor

Você já carregou as skills do agente do ClickHouse e conectou o ClickHouse MCP remoto ao seu agente de programação no módulo 00. Esse mesmo agente pode atuar como um instrutor competente no workshop. Cole nele o bloco abaixo, preenchendo o número do módulo e o que você está observando:

You are my workshop instructor. The workshop lives in this repo: the app is in workshops/build_workshop/app/, infrastructure notes are in workshops/build_workshop/infra/README.md, and the playbook markdown (learner and instructor tracks) is in site/content/docs/build-workshop. I am on module NN and stuck: <describe what you see>. Read the relevant module page and the troubleshooting page, inspect my local state (docker compose ps, container logs, and .env.workshop WITHOUT printing any secret values), and walk me to the module's verify step.

Como ele tem as skills e o MCP configurados no módulo 00, o agente também pode consultar seu serviço na nuvem diretamente enquanto ajuda — assim, ele consegue verificar se suas tabelas, seu pipe ou sua telemetria realmente chegaram, em vez de apenas ler a documentação.

Se quiser que o papel de instrutor permaneça entre as sessões, sem precisar colar o texto novamente, coloque-o no arquivo de instruções de projeto da ferramenta: CLAUDE.md para o Claude Code, AGENTS.md para o Codex CLI e .cursor/rules/ (ou AGENTS.md, que o Cursor também lê) para o Cursor. Cada ferramenta carrega automaticamente esse arquivo na raiz do repositório, portanto as orientações entram no contexto sempre que você abre o workshop.

Recomendações de ritmo

Os tempos previstos por módulo na visão geral pressupõem uma turma em que as contas foram criadas com antecedência. Por conta própria, o módulo 00 concentra a maior parte do tempo: os três cadastros no navegador (ClickHouse Cloud, Langfuse e OpenAI) levam de 5 a 10 minutos cada, principalmente por causa da espera pela verificação por e-mail ou telefone. O aviso para “criar as contas antes do dia do evento” em 00 Configuração é ainda mais importante quando você está sozinho — faça primeiro os três cadastros, volte com as chaves em mãos, e o restante do módulo 00 será rápido. Depois disso, os módulos 01 a 09 ficam próximos dos tempos indicados.

Você nunca ficará sem saída: a seção Ponto de partida de cada módulo informa exatamente o que precisa estar pronto, portanto você pode parar, voltar mais tarde e retomar dali.

Próximos passos