Cómo realizar este taller a tu ritmo

Este taller se ha diseñado para una sesión presencial con instructor, pero todo lo que necesitas para completarlo por tu cuenta ya se encuentra en esta guía. Si estás recorriendo el repositorio solo — o alguien lo compartió contigo después del evento —, esta página es tu mapa.

Elige macOS o Windows en el encabezado de la página antes de configurar nada. Quienes usan Windows ejecutan todos los comandos del taller en Ubuntu con WSL 2; PowerShell solo aparece en los bloques de preparación y recuperación de Windows que están etiquetados expresamente.

Qué cambia sin instructor

Respuesta breve: nada entre los módulos 00 y 07. El recorrido principal es completamente autoguiado. Tú creas tu propia prueba de ClickHouse Cloud, tu propio Postgres administrado por ClickHouse mediante clickhousectl (módulo 03) y tus propias claves de API; no dependes de ningún recurso compartido. Los módulos 04 a 09 son iguales.

Un instructor suele proporcionar dos cosas, y cada una dispone de una alternativa de autoservicio dentro de estos materiales:

• La clínica de configuración con personal de apoyo (módulo 00) se sustituye por ./preflight.sh en ClickHouse_Demos/workshops/build_workshop/app, que comprueba todo lo que suele bloquear la preparación en directo, y por la página Solución de problemas, que enumera todos los fallos observados durante las pruebas y su corrección exacta.
• La ayuda en directo para desbloquearte durante un módulo se sustituye por dos recursos: tu agente de programación actuando como instructor (más abajo) y el itinerario del instructor como solucionario (más abajo).

El itinerario del instructor es tu solucionario

El itinerario del instructor está publicado en esta misma guía. Cada módulo tiene una página correspondiente para el instructor con los tiempos, los fallos que se producen en la práctica y cómo resolverlos, además de los pasos de restablecimiento para volver a un estado conocido y funcional. Cuando un módulo no se comporte como indica su paso de verificación, abre la página correspondiente del instructor: está escrita precisamente para ese momento.

Tu agente de programación es tu instructor

Ya cargaste las skills del agente de ClickHouse y conectaste el ClickHouse MCP remoto a tu agente de programación en el módulo 00. Ese mismo agente puede ser un buen instructor del taller. Pega en él el bloque siguiente, indicando el número de módulo y lo que observas:

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 dispone de las skills y del MCP del módulo 00, el agente también puede consultar tu servicio en la nube directamente mientras te ayuda; así puede comprobar si las tablas, el pipe o la telemetría llegaron de verdad, en lugar de limitarse a leer la documentación.

Si quieres que el enfoque de instructor se conserve entre sesiones, sin tener que volver a pegarlo, colócalo en el archivo de instrucciones de proyecto de tu herramienta: CLAUDE.md para Claude Code, AGENTS.md para Codex CLI y .cursor/rules/ (o AGENTS.md, que Cursor también lee) para Cursor. Cada herramienta carga automáticamente ese archivo desde la raíz del repositorio, de modo que las instrucciones están presentes cada vez que abres el taller.

Consejos para marcar el ritmo

Los tiempos por módulo de la vista general presuponen un grupo que creó las cuentas con antelación. Por tu cuenta, el módulo 00 concentra la mayor parte del tiempo: los tres registros en el navegador (ClickHouse Cloud, Langfuse y OpenAI) tardan entre 5 y 10 minutos cada uno, sobre todo por la espera de la verificación por correo electrónico o teléfono. El aviso «crea las cuentas antes del día del taller» de 00 Configuración es aún más importante cuando trabajas solo: completa primero los tres registros, regresa con las claves preparadas y el resto del módulo 00 será rápido. Después, los módulos 01 a 09 se acercan a los tiempos indicados.

Nunca quedarás bloqueado: la sección Punto de partida de cada módulo especifica exactamente qué debe estar listo, de modo que puedes detenerte, volver más tarde y continuar desde ahí.

Siguientes pasos