DATAfest — Manual del equipo y checklist

Disponible en inglés y español (usa el botón EN / ES, arriba a la derecha). El producto va en español. Borrador para revisión de Diego antes de compartirlo con el socio.

Bienvenido. Así construimos DATAfest entre los dos. Está escrito para que alguien que nunca usó herramientas como estas pueda seguir cada paso. No damos por hecho que ya sabes de git, terminales ni código. Léelo una vez y déjalo como tu referencia. Sin prisa.

1. Qué es DATAfest (en una frase)

Mission control para el capitán. Un tablero completo para una empresa de conciertos: la vista siempre activa de todo el negocio, más la cabina de mando en vivo durante un festival. Autoridad tranquila, visión total, decisiones con señal en tiempo real.

2. El panorama: cómo trabajamos los dos

• Tú (socio): diseño, ideas y cómo se ve y se siente DATAfest.
• Diego + Claude: la construcción, los datos, la seguridad y la parte técnica.
• Tu superpoder: no necesitas aprender git ni escribir código. Claude son tus manos. Tú piensas y diseñas; le dices a Claude lo que quieres con palabras normales; Claude hace la parte técnica por ti.
• Una sola carpeta compartida: todo vive en una carpeta del proyecto (el "repo") que se sincroniza entre tu computadora y la de Diego. Esa carpeta es nuestro cerebro común. Cuando guardas algo, le aparece a Diego. Cuando Diego guarda algo, te aparece a ti.

3. Glosario en palabras simples (léelo una vez, regresa cuando quieras)

Sin tecnicismos. Una línea cada uno.

• Repo (repositorio): la carpeta compartida de DATAfest. Vive en línea (GitHub) y en la computadora de cada quien.
• GitHub: el sitio que guarda la carpeta en línea y nos mantiene sincronizados.
• Clonar: hacer una copia de la carpeta en línea en tu computadora (esto se hace una vez).
• Commit: guardar una foto de tus cambios, con una nota corta de qué cambió.
• Push / Pull: push sube tus cambios a GitHub; pull baja lo más reciente.
• Branch / Pull Request (PR): una copia paralela segura para un cambio, y la solicitud para integrarlo a la versión principal. Claude lo hace por ti. Tú nunca tienes que tocarlo.
• Terminal: la ventana de comandos de texto. No la vas a necesitar. Claude la usa por ti.
• VS Code: la app donde se abre el proyecto en tu computadora. Es tu taller.
• Claude Code: tu compañero de IA dentro de VS Code. Le hablas con palabras normales.
• GitHub Desktop: una app con botones que te muestra tus cambios y los sincroniza con un clic. Tu red de seguridad visual.
• Inbox: la carpeta inbox/. Tu puerta de entrada. Suelta cualquier idea ahí y la recogemos.
• Live Share: una forma de ver la misma pantalla en vivo, con los dos cursores, cuando trabajamos a distancia.
• Secretos / .env: contraseñas y llaves. Nunca van en la carpeta compartida. Claude las maneja de forma segura.

4. Tu configuración inicial (una sola vez)

Ya usas Claude Code en VS Code, igual que Diego, así que esto es muy corto: un par de cosas que solo tú puedes hacer, y después Claude arma el resto.

4A. Lo único que haces tú

1. Crea una cuenta de GitHub. Entra a github.com, da clic en Sign up, elige un nombre de usuario (tu nombre está bien) y confirma tu correo. Mándale tu usuario a Diego para que te agregue.
2. Acepta la invitación. Te llega un correo de invitación al equipo D-F-inc. Da clic en Accept. Ya eres co-dueño del proyecto.

Eso es todo de tu parte. De aquí en adelante, Claude hace la configuración.

4B. Deja que Claude arme el resto (copia, pega, envía, de uno en uno)

En tu Claude Code (el que ya usas), pega estos prompts de uno en uno y déjalo trabajar. Te explica cada paso en palabras simples y te pregunta antes de hacer algo importante. Ese es el punto de cómo trabajamos: tú dices qué quieres y Claude hace la parte técnica.

Prompt 1, traer el proyecto y poner a Claude al día:

"Ya entré a GitHub. Por favor clona nuestro repositorio D-F-inc/datafest, ábrelo y luego lee primero el README.md para que estés al día de qué estamos construyendo y cómo trabajamos. Después, guíame en mi configuración en términos simples, y dime lo que necesites de mí."

Prompt 2, armar mi mesa de trabajo:

"Configura mi mesa de trabajo para este proyecto. Asegúrate de que GitHub Desktop, Git y las extensiones recomendadas de VS Code (incluida Live Share) estén instaladas y listas. Explícame qué es cada herramienta y pregúntame antes de instalar o cambiar algo importante."

Prompt 3, conocer el proyecto:

"Lee el CLAUDE.md y el docs/manual.md de este proyecto y explícame en términos simples qué estamos construyendo, cuál es mi rol y exactamente cómo guardo y comparto mi trabajo. Que sea corto."

Prompt 4, revisión final:

"Revisa que todo quedó bien configurado y dime si ya estoy listo para trabajar. Luego dame una guía corta de las frases que puedo decirte para guardar mi trabajo, enviárselo a Diego y ponerme al día al iniciar una sesión."

Si algún prompt hace algo que no entiendes, pídele a Claude "explícame eso en términos simples", o escríbele a Diego. No puedes romper nada por preguntar.

La prueba de "saludo"

Cuando le puedas preguntar a Claude "¿Qué es DATAfest y cómo trabajamos?" y te conteste con la idea de mission control y este flujo, ya quedaste listo. 🎛️

5. Cómo trabajas, día con día (tu flujo simple)

Tu trabajo, en lo técnico, son tres movimientos. Claude hace todo lo demás.

1. Ten una idea o un diseño. Un boceto, una captura, una referencia que te gustó, una nota de voz, una idea suelta. Lo que sea.

2. Ponlo en el inbox. Arrastra el archivo a la carpeta inbox/, o dile a Claude: "Agrega esto al inbox: [descríbelo o pégalo]." Nada es demasiado crudo. El inbox es para ideas a medio cocinar, a propósito. De ahí le damos forma juntos.

3. Dile a Claude qué quieres, con palabras normales. Por ejemplo:

   • "Guarda mi trabajo."
   • "Mándale esto a Diego para que lo vea."
   • "Ponme al día con lo que cambió desde ayer."

   Claude lo convierte en los pasos técnicos correctos (los commits, las branches, la sincronización).

Tú nunca tocas git. Si alguna vez quieres ver tus cambios con tus propios ojos, abre GitHub Desktop: te lista lo que cambió; da clic en Push origin para sincronizar. Es el único botón que necesitas.

• Inicia una sesión: abre la carpeta y dile a Claude "ponme al día" (lee el último handoff y el inbox).
• Cierra una sesión: dile a Claude "guarda mi trabajo y escribe un handoff." Eso le pasa la estafeta a Diego (y a su Claude) sin problemas.

6. Cómo trabajamos juntos (presencial y a distancia)

Hacemos una mezcla de los dos, y el flujo sirve igual:

• Presencial: nos sentamos juntos, una pantalla, y lo platicamos.
• A distancia: entramos a una llamada y prendemos VS Code Live Share para ver la misma pantalla en vivo, los dos cursores. Se siente como estar juntos.
• En cualquier caso, la carpeta compartida lleva todo entre los dos, así que aunque estemos separados nuestros dos Claudes siguen sincronizados. El repo es la memoria que ninguno de los chats ve por su cuenta.

7. Quién es dueño de qué

• Tú: el espacio design/, el look and feel, los flujos, las ideas.
• Diego + Claude: el backend, los tools/, la seguridad y la infraestructura.
• Nos revisamos el trabajo y trabajamos en pareja seguido. Nada de esto es un muro.

8. Las reglas de oro (cortas, y sí importan)

• Nunca pongas contraseñas ni llaves en la carpeta compartida. Si algo es secreto, dile a Claude y lo maneja de forma segura (local, nunca sincronizado).
• Si tienes duda, pregunta. A tu Claude o a Diego. Ninguna pregunta es muy chica.
• Poco y seguido le gana a mucho y de vez en cuando. Guarda y comparte en pedazos chicos.
• El producto va en español. Y en cualquier texto que escribamos, sin guiones largos.

9. El camino hacia nuestras metas

Vamos por fases. No definimos el producto de antemano; eso sale de tu diseño más la investigación.

Cada fase corre el mismo ciclo: idea, le damos forma juntos, plan, construir, revisar, lanzar.

10. Tu primera sesión con nosotros (qué esperar)

La meta de la primera sesión es simple: dejarte listo y que veas cómo trabajamos. Vamos a:

1. Hacer tu configuración (Sección 4) en vivo, juntos: crear tu cuenta de GitHub y luego ver a Claude armar todo el proyecto en tu máquina con un par de prompts.
2. Mostrarte el ritmo: ves a Diego y a Claude hacer un pedazo de trabajo real, para que sientas qué tan rápido y simple es el flujo.
3. Calentar las ideas: trae lo que hayas imaginado para DATAfest. Lo soltamos en el inbox y empezamos a darle forma.

Sin presión, sin más preparación que llegar con curiosidad. El guion detallado está en kickoff-session.md.

11. Tarjeta de referencia rápida (tu acordeón)

• Empezar a trabajar: abre la carpeta y "Claude, ponme al día."
• Guardar una idea: suéltala en inbox/ y "Claude, guarda esto."
• Enviar para revisión: "Claude, mándale esto a Diego."
• Ver mis cambios: abre GitHub Desktop y Push origin.
• Atorado o con duda: pregúntale a Claude, o escríbele a Diego.

Esta página se genera desde el manual y vive en una URL privada de revisión, donde tú y tu socio pueden dejar comentarios y Claude los lee para iterar.