14 Nivel 1: La Cueva

Author

Diego Saavedra García

15 🕳️ Nivel 1: La Cueva

15.1 “Tony no tenía nada. Solo determinación.”

15.2 🎯 Objetivo del Nivel

Al terminar este nivel podrás:

✅ Conversar con una IA de forma efectiva
✅ Dirigir sin micromanage — dar dirección, no comandos
✅ Iterar hasta obtener lo que necesitas
✅ Verificar que el resultado sea lo que pediste

Tu rol: Tony Stark en la cueva. Tenés la visión, JARVIS tiene las manos.

15.3 🤖 Herramienta: Gemini CLI

15.3.1 ¿Por qué Gemini CLI?

Característica	Gemini CLI
Costo	Gratis
Tokens	1M (contexto enorme)
Configuración	Cero — listo en 2 minutos
Ideal para	Primeros pasos, aprender conversación

💡 Nota: Cualquier IA sirve para este nivel. Usamos Gemini CLI porque es gratis y no requiere configuración. Los conceptos aplican a Claude, ChatGPT, o cualquier otra.

15.4 🎬 La Escena

Iron Man (2008) — Tony Stark está en una cueva en Afganistán. Herido, cautivo, sin recursos.

Lo único que tiene: un генератор de energía improvisado y la capacidad de pedir ayuda.

TONY: "Necesito que construyas algo que me mantenga vivo."
YINSEN: "¿Algo como qué?"
TONY: "Algo que... convenza a mi cuerpo de que no está muriendo."

Tony no construye solo. Pide. Pregunta. Dirige. Yinsen ejecuta.

Vos sos Tony. Gemini CLI es tu Yinsen/JARVIS.

15.5 🎭 Tu Rol: Tony en la Cueva

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   VOS (Tony)                            JARVIS (IA)                          │
│   ─────────                            ──────────────                        │
│                                                                              │
│   • Tenés la VISIÓN                   • Lee tu mensaje                      │
│   • Definís el QUÉ y POR QUÉ          • Ejecuta comandos                    │
│   • Apruebas o RECHAZAS                • Sugiere alternativas                │
│   • Decidís la DIRECCIÓN               • Pregunta si no entiende             │
│                                                                              │
│   VOS NUNCA CODIFICA                  JARVIS NUNCA DECIDE SOLO              │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Regla de oro: Si te sorprendés de lo que hizo JARVIS, preguntá POR QUÉ.

15.6 🔑 Concepto Clave: La Conversación

15.6.1 ❌ ANTES (Enfoque WRONG)

VOS: "Escribíme un programa que haga X"
JARVIS: [escribe código completo]
VOS: [copia y pega]
VOS: "No funciona"
JARVIS: [escribe más código]
VOS: [copia y pega]
... (ciclo infinito)

Problema: No entendés qué hiciste. Si algo rompe, no sabés arreglarlo.

15.6.2 ✅ AHORA (Enfoque Tony Stark)

VOS: "JARVIS, necesito una función que haga X. 
      ¿Cuál es la mejor forma de hacerlo?"
JARVIS: "Para X te recomiendo Y porque Z."
VOS: "Perfecto, hacelo. Pero agregá validación de errores."
JARVIS: "Hecho. ¿Querés que agregue tests?"
VOS: "Sí, y explicame cada test."
JARVIS: [implementa + explica]
VOS: "Bien. Guardalo."

Ventaja: Entendés cada paso. Podés verificar. Podés dirigir.

15.7 🧪 Lab 1: Tu Primera Conversación

15.7.1 Objetivo

Iniciar una conversación con JARVIS y verificar que responde.

15.7.2 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Instalar Gemini CLI	2 min	⬜
2	Iniciar conversación	1 min	⬜
3	Tu primer mensaje	2 min	⬜
4	Iterar hasta entender	5 min	⬜

15.7.3 Escenario

Estás en la cueva. JARVIS está listo para ayudarte. Necesitás entender qué puede hacer por vos.

15.7.4 Paso 1: Instalar Gemini CLI

Tu tarea: Instalar la herramienta en tu computadora.

Pista: Se instala con npm, el gestor de paquetes de Node.js

Comando parcial para completar: npm install -

Resultado esperado:

added X packages in Ys

15.7.5 Paso 2: Iniciar conversación

Tu tarea: Lanzar JARVIS.

Pista: El comando para ejecutar es simplemente el nombre del paquete

Comando parcial: gem

Resultado esperado:

🤖 Gemini CLI

¿Qué te gustaría hacer hoy?
>

15.7.6 Paso 3: Tu primer mensaje

Tu tarea: Escribir tu primer mensaje a JARVIS.

NO copies esto tal cual. Personalizalo:

> Hola JARVIS. Soy nuevo en esto. 
> ¿Podrías explicarme qué puedes hacer y cómo podemos trabajar juntos?

Pregunta de verificación: ¿Qué respondió JARVIS? En tus propias palabras:

JARVIS puede: _________________________________________
Podemos trabajar juntos porque: _______________________

15.7.7 Paso 4: Iterar hasta entender

Tu tarea: Hacer al menos 3 preguntas de seguimiento.

Ejemplos de preguntas válidas:

“¿Cómo te doy contexto sobre mi proyecto?”
“¿Puedes ver archivos en mi computadora?”
“¿Cómo te digo que algo no es lo que quería?”

Tu conversación:

PREGUNTA 1: _________________________________________
RESPUESTA: _________________________________________

PREGUNTA 2: _________________________________________
RESPUESTA: _________________________________________

PREGUNTA 3: _________________________________________
RESPUESTA: _________________________________________

15.8 🧪 Lab 2: Pidiendo Algo Específico

15.8.1 Objetivo

Aprender a estructurar un pedido para obtener lo que necesitás.

15.8.2 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Escribir pedido estructurado	3 min	⬜
2	Enviar a JARVIS	1 min	⬜
3	Revisar respuesta	2 min	⬜
4	Dar feedback	3 min	⬜

15.8.3 Escenario

Tony necesita algo específico: “JARVIS, necesito una fuente de energía pequeña que quepa en mi pecho.”

15.8.4 Fórmula del Pedido Estructurado

[PEDIDO] + [CONTEXTO] + [RESTRICCIONES] + [FORMATO]

Parte	Qué decir	Ejemplo
PEDIDO	Qué querés	“Necesito una función que…”
CONTEXTO	Para qué	“…para validar emails de usuarios”
RESTRICCIONES	Reglas	“…debe usar regex y retornar boolean”
FORMATO	Cómo lo querés	“…con comentarios en español”

15.8.5 Tu tarea: Escribir un pedido

Completá el siguiente pedido:

Hola JARVIS,

PEDIDO: Necesito ________________________________________________

CONTEXTO: ______________________________________________________

RESTRICCIONES: 
- _____________________________________________________________
- _____________________________________________________________

FORMATO: Quiero que ____________________________________________

¿Podrías hacerlo y explicarme cada parte?

Tu pedido completo:

[JESCRIBA EL PEDIDO COMPLETO AQUÍ]

15.8.6 Enviar y revisar

Tu tarea: Enviar el pedido a JARVIS.

Pregunta de verificación:

¿JARVIS hizo lo que pediste? SÍ / NO
Si NO, ¿qué faltó? _____________________________________________

15.8.7 Dar feedback

Regla: Si no es exactamente lo que querés, decilo.

Plantilla de feedback:

JARVIS, gracias. Pero necesito que ______________________________
Específicamente: ________________________________________________
¿Podrías ajustarlo?

Tu feedback (si corresponde):

JARVIS, gracias. Pero necesito que ______________________________

15.9 🧪 Lab 3: Diciendo “No Es Lo Que Quería”

15.9.1 Objetivo

Aprender a corregir sin frustración — JARVIS no se ofende.

15.9.2 ⏱️ Timeline

Paso	Descripción	Tiempo	✓
1	Pedir algo	2 min	⬜
2	Identificar qué está mal	2 min	⬜
3	Escribir feedback específico	3 min	⬜
4	Verificar corrección	2 min	⬜

15.9.3 Escenario

Tony dice “No, no es eso. Necesito que haga X, no Y.”

JARVIS no se enoja. Corrige. Sigue.

15.9.4 Tu tarea: Provocar un error

Paso 1: Pedí algo con intencionalidad ambigua.

> JARVIS, creá una función que procese datos de usuarios.

Paso 2: Identificá qué está MAL o qué FALTA.

Paso 3: Escribí feedback específico:

Tu respuesta tiene X, pero necesito Y.
Ejemplo: "Incluye manejo de errores" 
         "No necesita base de datos"
         "Debe funcionar offline"

Tu feedback específico:

> JARVIS, la función que me diste tiene _____________ pero necesito _____________
> Específicamente: _____________________________________________________________
> Por qué importa: _____________________________________________________________

Paso 4: Verificá si JARVIS corrigió correctamente.

15.10 🎯 Verificación del Nivel

15.10.1 Checklist Final

Habilidad	Demostrable cuando…	✓
Conversar	Pudiste hacer 3+ preguntas de seguimiento	⬜
Dirigir	JARVIS hizo algo que vos especificaste	⬜
Iterar	Diste feedback y JARVIS corrigió	⬜
Verificar	Explicás POR QUÉ JARVIS hizo cada cosa	⬜

15.10.2 Prueba de fuego

Intentá esto con JARVIS:

> JARVIS, necesito que me expliques qué es un "prompt estructurado"
> como si tuviera 10 años. Dame un ejemplo con algo de la vida real,
> no con código. Después preguntame si entendí antes de continuar.

Tu respuesta:

¿Entendí el concepto? SÍ / NO
Lo que entendí: _______________________________________________________________

15.11 📚 Recursos

15.11.1 Lectura recomendada

Prompt Engineering Guide — Guía completa de prompts
Conversational AI Patterns — Cómo habla Claude

15.11.2 Tu kit de conversación

Banco de prompts básicos: Ver recursos/prompts-banco.md
Fórmulas probadas: Ver recursos/formulas-conversacion.md

15.12 🏆 Logro Desbloqueado

15.12.1 “Cave Dweller”

Requisitos: - [ ] Completaste 3 conversaciones con JARVIS - [ ] Diste feedback específico al menos una vez - [ ] Explicás la diferencia entre directed vs dictated - [ ] Completaste la prueba de fuego

Recompensa: - 🔓 Acceso al Nivel 2: Mark I - 📁 Template de conversación guardado en tu kit

15.13 🔗 Siguiente Nivel

¿Completaste todos los labs?

→ Nivel 2: Mark I — Configura tu armadura

¿Necesitas más práctica?

→ Lab Detallado: Conversación N1

💡 Filosofía del nivel:

“Tony Stark no sabía cómo construir el reactor arc. Sabía que lo necesitaba. JARVIS supo cómo construirlo.”

Tu trabajo: Saber qué necesitás. El trabajo de JARVIS: hacerlo.

--- title: "Nivel 1: La Cueva" author: "Diego Saavedra García" description: "Tu primera conversación con JARVIS - Aprende a orquestar IA, no a escribir código" image: images/nivel1-cueva.jpg --- # 🕳️ Nivel 1: La Cueva ## "Tony no tenía nada. Solo determinación." --- ## 🎯 Objetivo del Nivel Al terminar este nivel podrás: - ✅ **Conversar** con una IA de forma efectiva - ✅ **Dirigir** sin micromanage — dar dirección, no comandos - ✅ **Iterar** hasta obtener lo que necesitas - ✅ **Verificar** que el resultado sea lo que pediste **Tu rol:** Tony Stark en la cueva. Tenés la visión, JARVIS tiene las manos. --- ## 🤖 Herramienta: Gemini CLI ### ¿Por qué Gemini CLI? | Característica | Gemini CLI | |----------------|------------| | Costo | **Gratis** | | Tokens | 1M (contexto enorme) | | Configuración | **Cero** — listo en 2 minutos | | Ideal para | Primeros pasos, aprender conversación | > 💡 **Nota:** Cualquier IA sirve para este nivel. Usamos Gemini CLI porque es gratis y no requiere configuración. Los conceptos aplican a Claude, ChatGPT, o cualquier otra. --- ## 🎬 La Escena **Iron Man (2008)** — Tony Stark está en una cueva en Afganistán. Herido, cautivo, sin recursos. Lo único que tiene: un генератор de energía improvisado y la capacidad de **pedir ayuda**. ``` TONY: "Necesito que construyas algo que me mantenga vivo." YINSEN: "¿Algo como qué?" TONY: "Algo que... convenza a mi cuerpo de que no está muriendo." ``` **Tony no construye solo.** Pide. Pregunta. Dirige. Yinsen ejecuta. **Vos sos Tony. Gemini CLI es tu Yinsen/JARVIS.** --- ## 🎭 Tu Rol: Tony en la Cueva ``` ┌──────────────────────────────────────────────────────────────────────────────┐ │ │ │ VOS (Tony) JARVIS (IA) │ │ ───────── ────────────── │ │ │ │ • Tenés la VISIÓN • Lee tu mensaje │ │ • Definís el QUÉ y POR QUÉ • Ejecuta comandos │ │ • Apruebas o RECHAZAS • Sugiere alternativas │ │ • Decidís la DIRECCIÓN • Pregunta si no entiende │ │ │ │ VOS NUNCA CODIFICA JARVIS NUNCA DECIDE SOLO │ │ │ └──────────────────────────────────────────────────────────────────────────────┘ ``` **Regla de oro:** Si te sorprendés de lo que hizo JARVIS, preguntá POR QUÉ. --- ## 🔑 Concepto Clave: La Conversación ### ❌ ANTES (Enfoque WRONG) ``` VOS: "Escribíme un programa que haga X" JARVIS: [escribe código completo] VOS: [copia y pega] VOS: "No funciona" JARVIS: [escribe más código] VOS: [copia y pega] ... (ciclo infinito) ``` **Problema:** No entendés qué hiciste. Si algo rompe, no sabés arreglarlo. ### ✅ AHORA (Enfoque Tony Stark) ``` VOS: "JARVIS, necesito una función que haga X. ¿Cuál es la mejor forma de hacerlo?" JARVIS: "Para X te recomiendo Y porque Z." VOS: "Perfecto, hacelo. Pero agregá validación de errores." JARVIS: "Hecho. ¿Querés que agregue tests?" VOS: "Sí, y explicame cada test." JARVIS: [implementa + explica] VOS: "Bien. Guardalo." ``` **Ventaja:** Entendés cada paso. Podés verificar. Podés dirigir. --- ## 🧪 Lab 1: Tu Primera Conversación ### Objetivo Iniciar una conversación con JARVIS y verificar que responde. ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Instalar Gemini CLI | 2 min | ⬜ | | 2 | Iniciar conversación | 1 min | ⬜ | | 3 | Tu primer mensaje | 2 min | ⬜ | | 4 | Iterar hasta entender | 5 min | ⬜ | --- ### Escenario Estás en la cueva. JARVIS está listo para ayudarte. Necesitás entender qué puede hacer por vos. --- ### Paso 1: Instalar Gemini CLI **Tu tarea:** Instalar la herramienta en tu computadora. **Pista:** Se instala con npm, el gestor de paquetes de Node.js **Comando parcial para completar:** `npm install -` **Resultado esperado:** ``` added X packages in Ys ``` --- ### Paso 2: Iniciar conversación **Tu tarea:** Lanzar JARVIS. **Pista:** El comando para ejecutar es simplemente el nombre del paquete **Comando parcial:** `gem` **Resultado esperado:** ``` 🤖 Gemini CLI ¿Qué te gustaría hacer hoy? > ``` --- ### Paso 3: Tu primer mensaje **Tu tarea:** Escribir tu primer mensaje a JARVIS. **NO copies esto tal cual.** Personalizalo: ``` > Hola JARVIS. Soy nuevo en esto. > ¿Podrías explicarme qué puedes hacer y cómo podemos trabajar juntos? ``` **Pregunta de verificación:** ¿Qué respondió JARVIS? En tus propias palabras: ``` JARVIS puede: _________________________________________ Podemos trabajar juntos porque: _______________________ ``` --- ### Paso 4: Iterar hasta entender **Tu tarea:** Hacer al menos 3 preguntas de seguimiento. **Ejemplos de preguntas válidas:** 1. "¿Cómo te doy contexto sobre mi proyecto?" 2. "¿Puedes ver archivos en mi computadora?" 3. "¿Cómo te digo que algo no es lo que quería?" **Tu conversación:** ``` PREGUNTA 1: _________________________________________ RESPUESTA: _________________________________________ PREGUNTA 2: _________________________________________ RESPUESTA: _________________________________________ PREGUNTA 3: _________________________________________ RESPUESTA: _________________________________________ ``` --- ## 🧪 Lab 2: Pidiendo Algo Específico ### Objetivo Aprender a estructurar un pedido para obtener lo que necesitás. ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Escribir pedido estructurado | 3 min | ⬜ | | 2 | Enviar a JARVIS | 1 min | ⬜ | | 3 | Revisar respuesta | 2 min | ⬜ | | 4 | Dar feedback | 3 min | ⬜ | --- ### Escenario Tony necesita algo específico: "JARVIS, necesito una fuente de energía pequeña que quepa en mi pecho." --- ### Fórmula del Pedido Estructurado ``` [PEDIDO] + [CONTEXTO] + [RESTRICCIONES] + [FORMATO] ``` | Parte | Qué decir | Ejemplo | |-------|-----------|---------| | **PEDIDO** | Qué querés | "Necesito una función que..." | | **CONTEXTO** | Para qué | "...para validar emails de usuarios" | | **RESTRICCIONES** | Reglas | "...debe usar regex y retornar boolean" | | **FORMATO** | Cómo lo querés | "...con comentarios en español" | --- ### Tu tarea: Escribir un pedido **Completá el siguiente pedido:** ``` Hola JARVIS, PEDIDO: Necesito ________________________________________________ CONTEXTO: ______________________________________________________ RESTRICCIONES: - _____________________________________________________________ - _____________________________________________________________ FORMATO: Quiero que ____________________________________________ ¿Podrías hacerlo y explicarme cada parte? ``` **Tu pedido completo:** ``` [JESCRIBA EL PEDIDO COMPLETO AQUÍ] ``` --- ### Enviar y revisar **Tu tarea:** Enviar el pedido a JARVIS. **Pregunta de verificación:** ``` ¿JARVIS hizo lo que pediste? SÍ / NO Si NO, ¿qué faltó? _____________________________________________ ``` --- ### Dar feedback **Regla:** Si no es exactamente lo que querés, decilo. **Plantilla de feedback:** ``` JARVIS, gracias. Pero necesito que ______________________________ Específicamente: ________________________________________________ ¿Podrías ajustarlo? ``` **Tu feedback (si corresponde):** ``` JARVIS, gracias. Pero necesito que ______________________________ ``` --- ## 🧪 Lab 3: Diciendo "No Es Lo Que Quería" ### Objetivo Aprender a corregir sin frustración — JARVIS no se ofende. ### ⏱️ Timeline | Paso | Descripción | Tiempo | ✓ | |------|-------------|--------|---| | 1 | Pedir algo | 2 min | ⬜ | | 2 | Identificar qué está mal | 2 min | ⬜ | | 3 | Escribir feedback específico | 3 min | ⬜ | | 4 | Verificar corrección | 2 min | ⬜ | --- ### Escenario Tony dice "No, no es eso. Necesito que haga X, no Y." JARVIS no se enoja. Corrige. Sigue. --- ### Tu tarea: Provocar un error **Paso 1:** Pedí algo con intencionalidad ambigua. ``` > JARVIS, creá una función que procese datos de usuarios. ``` **Paso 2:** Identificá qué está MAL o qué FALTA. **Paso 3:** Escribí feedback específico: ``` Tu respuesta tiene X, pero necesito Y. Ejemplo: "Incluye manejo de errores" "No necesita base de datos" "Debe funcionar offline" ``` **Tu feedback específico:** ``` > JARVIS, la función que me diste tiene _____________ pero necesito _____________ > Específicamente: _____________________________________________________________ > Por qué importa: _____________________________________________________________ ``` **Paso 4:** Verificá si JARVIS corrigió correctamente. --- ## 🎯 Verificación del Nivel ### Checklist Final | Habilidad | Demostrable cuando... | ✓ | |-----------|------------------------|---| | **Conversar** | Pudiste hacer 3+ preguntas de seguimiento | ⬜ | | **Dirigir** | JARVIS hizo algo que vos especificaste | ⬜ | | **Iterar** | Diste feedback y JARVIS corrigió | ⬜ | | **Verificar** | Explicás POR QUÉ JARVIS hizo cada cosa | ⬜ | --- ### Prueba de fuego Intentá esto con JARVIS: ``` > JARVIS, necesito que me expliques qué es un "prompt estructurado" > como si tuviera 10 años. Dame un ejemplo con algo de la vida real, > no con código. Después preguntame si entendí antes de continuar. ``` **Tu respuesta:** ``` ¿Entendí el concepto? SÍ / NO Lo que entendí: _______________________________________________________________ ``` --- ## 📚 Recursos ### Lectura recomendada - [Prompt Engineering Guide](https://www.promptingguide.ai/) — Guía completa de prompts - [Conversational AI Patterns](https://docs.anthropic.com/) — Cómo habla Claude ### Tu kit de conversación - **Banco de prompts básicos:** Ver `recursos/prompts-banco.md` - **Fórmulas probadas:** Ver `recursos/formulas-conversacion.md` --- ## 🏆 Logro Desbloqueado ### "Cave Dweller" **Requisitos:** - [ ] Completaste 3 conversaciones con JARVIS - [ ] Diste feedback específico al menos una vez - [ ] Explicás la diferencia entre directed vs dictated - [ ] Completaste la prueba de fuego **Recompensa:** - 🔓 Acceso al **Nivel 2: Mark I** - 📁 Template de conversación guardado en tu kit --- ## 🔗 Siguiente Nivel **¿Completaste todos los labs?** [→ **Nivel 2: Mark I** — Configura tu armadura](nivel2.qmd) **¿Necesitas más práctica?** [→ **Lab Detallado: Conversación N1**](../labs/lab-nivel1.md) --- > 💡 **Filosofía del nivel:** > > *"Tony Stark no sabía cómo construir el reactor arc. Sabía que lo necesitaba. JARVIS supo cómo construirlo."* > > **Tu trabajo:** Saber qué necesitás. El trabajo de JARVIS: hacerlo.