AI Squad Hackathon

01 · El concepto

¿Qué es Claude?

Claude es una inteligencia artificial con la que hablás como con una persona: le escribís en castellano lo que necesitás y te responde. Sirve para redactar, resumir, analizar, sacarte dudas, ordenar información. Por dentro es un modelo de lenguaje (un "LLM"): un sistema entrenado con enormes cantidades de texto que predice la mejor respuesta a lo que le pedís.

02 · Cómo se le pide

El prompt (y cómo pedir bien)

El prompt es lo que le pedís, escrito en palabras. La diferencia entre un resultado útil y uno genérico casi siempre está acá. Estas son las buenas prácticas oficiales de Anthropic, bajadas a criollo:

• Sé claro y directo. Pensá en Claude como un asistente nuevo y brillante que todavía no conoce tu contexto: cuanto más preciso, mejor sale. No "analizá la cuenta" sino "revisá las campañas de Search de los últimos 30 días y marcame las de CTR bajo".
• Explicale el porqué. Si le decís para qué es, ajusta mejor. Ej: "esto lo va a leer el cliente, así que cuidá el tono."
• Dale un rol. "Actuá como un analista senior de Paid Media." Una sola frase ya enfoca el tono y el criterio.
• Mostrale ejemplos. 3-5 ejemplos de lo que esperás (un reporte viejo que te gustó, el formato que usás). Es de lo que más mueve la aguja.
• Decile el formato — y qué hacer, no qué evitar. "Como tabla", "en 5 bullets", "como un mail." Mejor "escribilo en prosa" que "no uses listas".
• Pedile que piense y se revise. "Pensá paso a paso", y "antes de cerrar, revisá los números contra el Excel."

Un ejemplo completo, marcado parte por parte

Así se ve un prompt que usa las 6 prácticas juntas. Cada letra marca una parte:

03 · Que te conozca

Memoria

Claude puede recordar cosas tuyas entre conversaciones: tus preferencias, cómo te gusta que trabaje, datos que le diste una vez. Así no le repetís lo mismo cada vez que abrís una charla nueva. Vos controlás qué recuerda y lo podés borrar cuando quieras.

04 · Tus documentos

Archivos

Podés subirle archivos —un PDF, un Excel, una imagen, un export de campañas— y Claude los lee y trabaja sobre ellos: te los resume, te saca los números, te arma un reporte. En vez de copiar y pegar a mano, le pasás el archivo y listo.

05 · Tu espacio de trabajo

Proyectos

Un Proyecto es un espacio dedicado a un tema, donde dejás fijas las instrucciones y los archivos que Claude tiene que tener siempre a mano. Por ejemplo, un proyecto "Reportes Omint" con el formato, las métricas que miramos y los últimos exports. No se lo explicás cada vez: ya vive ahí.

Y lo más importante para el squad: un Proyecto se comparte con colegas. Todo el equipo trabaja sobre el mismo espacio, con las mismas instrucciones y archivos.

06 · Lo que te entrega

Artifacts

Cuando Claude te arma algo "entregable" —un documento, una tabla, un tablero, hasta una mini-app— lo muestra en un panel al costado (un "Artifact") que podés ver, ir ajustando y compartir, sin que se pierda en medio de la conversación. Ahora también está disponible en la app de escritorio, no solo en el navegador.

07 · Agente sin terminal

Cowork

Cowork es el poder de un agente, pero sin tocar la terminal. Vive en la app de escritorio de Claude: le das un objetivo (no prompt por prompt) y Claude trabaja solo sobre tus archivos, carpetas y aplicaciones, y te devuelve algo terminado.

Por ejemplo: apuntalo a una carpeta de borradores y archivos sueltos y pedile que los ordene, renombre y te diga qué es importante; o pasale las fuentes de un reporte y que te arme el borrador estructurado. Es la forma más fácil de tener un agente trabajando para vos. (Disponible en los planes pagos de Claude.)

08 · El puente

Y entonces, ¿qué es Claude Code?

Claude Code es el mismo Claude, pero como agente que vive en la terminal. Es el hermano técnico de Cowork: en vez de la app de escritorio, trabaja en la terminal, donde puede conectarse a APIs, versionar el trabajo en Git y construir agentes y runbooks de verdad.

Es lo que vamos a usar el finde para construir los agentes del squad. Lo vemos en detalle en la Parte 2.

09 · El salto

¿Qué es un agente?

Un chat te contesta; un agente además hace el trabajo: abre el archivo, corre el cálculo, le pide datos a Google Ads, arma el reporte y lo guarda. La diferencia es que actúa, no solo responde.

Por dentro no hay magia: el agente hace exactamente lo que harías vos, solo que más rápido. Tiene cuatro herramientas básicas —leer archivos, escribir archivos, correr comandos y buscar— y con eso resuelve todo. Cuando lo veas trabajar vas a poder leer en pantalla qué está haciendo, y darte cuenta si va bien o se está yendo por las ramas.

10 · Dónde vive

La terminal

Claude Code vive en la terminal. Para mucha gente la terminal es esa "pantalla negra de hacker" que da un poco de miedo. No lo es: es, simplemente, una forma de hablarle a tu computadora escribiendo en vez de haciendo clic. Y la buena noticia: casi no vas a tipear comandos raros — el 90% del tiempo le escribís a Claude en castellano, como un chat, y él se encarga del resto.

Cómo abrir la terminal (Mac)

• Apretá Cmd + barra espaciadora (se abre Spotlight).
• Escribí Terminal y Enter.
• Se abre una ventana con texto. Esa es la terminal.

(Si venís con Windows, avisanos y te lo dejamos andando el jueves.)

11 · Qué vas a ver

Cómo es una sesión

• Le escribís lo que querés, en castellano.
• Te muestra lo que va haciendo ("estoy abriendo el archivo", "estoy contando las campañas"). Es transparente.
• Te pide permiso antes de tocar algo importante. Antes de modificar/crear un archivo o correr algo, pregunta "¿hago esto?". Nada pasa a tus espaldas.
• Te entrega el resultado, lo revisás, y si algo está mal le decís qué cambiar.

12 · El recurso escaso

El contexto (y el CLAUDE.md)

El agente no se acuerda de una tarea a la otra: cada conversación arranca de cero. Lo que tiene es contexto: lo que está "en su cabeza" en esta charla. Pero el contexto es finito (se llena) y se ensucia (cuanto más largo y desordenado, peor responde). Por eso: dale lo justo, no todo, y si se hizo larga la charla, arrancá de nuevo.

Para que "recuerde" lo importante sin repetírselo, se usa un archivo de instrucciones (el CLAUDE.md): el manual de bienvenida que el agente lee siempre. Ahí va lo permanente —"las cuentas son estas, el CPA se calcula así, esto nunca lo toques"—, separado de lo que le pedís en el momento.

13 · Tareas embotelladas

Skills

Una skill es una carpetita con instrucciones + plantillas que le enseña al agente a hacer una tarea bien y siempre igual (ej: "Reporte mensual de cliente Growketing", que ya sabe qué mirar y con qué formato). El agente la carga solo cuando hace falta. La explicás una vez y la calidad sale pareja la use quien la use.

14 · El contrato

Runbooks

Un runbook es la receta escrita de lo que hace el agente: paso por paso, qué datos toma, qué decide. Importa por dos cosas: lo puede auditar cualquiera (alguien que no lo escribió entiende por qué el agente dice lo que dice) y se reusa (lo aplicás a 1 cuenta o a 50 igual).

15 · El laburo compartido

Git y GitHub

Git guarda el historial de un proyecto (como el historial de versiones de Google Docs, pero para carpetas de trabajo). Las palabras que vas a escuchar:

• Repo — la carpeta-proyecto con su historial ("el repo de skills" = donde viven las skills del equipo).
• GitHub — la web donde viven los repos online para compartirlos. El Google Drive de los repos.
• Clonar — bajar una copia del repo a tu compu.
• Commit — guardar un cambio con una nota de qué hiciste.
• Push — subir tus cambios a GitHub para que los demás los vean.
• Branch (rama) — una copia paralela para probar sin romper lo que funciona.

16 · Nuestra plataforma

Yais

Yais es la plataforma interna de Growketing donde van a vivir y correr los agentes y runbooks. Pensala como el lugar donde, en vez de abrir la terminal, apretás un botón y el agente hace su laburo. Hoy, por ejemplo, Finanzas ya la usa para consultar el P&L.

La forma de pensarlo: mientras construimos un agente, vive en Claude Code / la terminal (el taller); cuando ya funciona bien, se lleva a Yais (la vidriera, donde cualquiera lo usa sin tocar la terminal).

17 · Los permisos

APIs, MCP, tokens y API keys

Una API es la "ventanilla" de un servicio (Google Ads, GA4, Meta) por donde un programa pide datos sin entrar a la web a mano. Un MCP es la forma estándar de enchufarle herramientas al agente —como un USB universal—; cuando alguien diga "el MCP de Yais", pensá "la conexión que le da al agente acceso a Yais".

Para entrar a esas ventanillas hacen falta llaves, de dos tipos: tu acceso a Claude (tu cuenta, que habilita el uso del agente) y las API keys de los servicios (Google Ads, Meta…). Una API key es una contraseña: quien la tiene puede usar el servicio como si fuera vos. Nunca se comparten. Y este finde, todas las llaves de los servicios son de solo lectura: el agente mira, no toca.

18 · No se rompen

Tres reglas de seguridad

19 · La pisada justa

Ventajas y desventajas

Guía rápida

¿Cuándo usar qué?

Tenés cuatro formas de trabajar con Claude. La regla simple: cuanto más "hacé esto solo" y más técnico, más te corrés hacia la derecha.