1. INTRODUCCIÓN

El mapa que necesitas para no perderte

Si te sientes estancado usando Cloud Code, probablemente no sea que lo estés usando mal, sino que no tienes un mapa claro que te permita saber si estás progresando. Cada semana aparecen nuevas funcionalidades y herramientas que te desvían el foco de lo que realmente importa para volverte mejor usando esta herramienta tan potente.

Luego de trabajar cientos y cientos de horas con Cloud Code, puedo decirte con total certeza que hay seis niveles que tienes que dominar. La gran mayoría de los usuarios se quedan estancados en el primero o en el segundo, sin siquiera imaginar el potencial real que tienen delante.

Este curso no es un manual de instrucciones más. Es una hoja de ruta práctica y probada. En cada nivel te voy a mostrar:

• Cómo reconocer si estás en ese nivel.

• Las habilidades concretas que debes dominar.

• El obstáculo principal que frena a la mayoría.

• La llave de acceso para desbloquear el siguiente nivel.

El objetivo final es claro: pasar de ser un simple "prompteador" a convertirte en un "orquestador" que hace que la IA trabaje para ti de manera inteligente, eficiente y profesional.

2. NIVEL 1: EL PROMPTEADOR

De cero a algo (aunque sea mediocre)

¿Cómo reconocer si estás aquí?

Si te encuentras en el nivel uno, probablemente estés usando Cloud Code desde la aplicación de escritorio de Cloud y no desde una terminal. No usas Visual Studio Code ni Antigravity; vas directo a la aplicación de escritorio. Esto no está mal y no te pierdes de ninguna funcionalidad esencial, pero sí muestra que todavía no lo estás aprovechando del todo.

Tu dinámica habitual es la siguiente: abres Cloud Code y lo tratas como si fuese idéntico al chat normal (ChatGPT). Lanzas prompts de la nada, sin trabajo previo, sin contexto y sin un espacio de trabajo organizado. Por ejemplo, simplemente dices: "Bueno, hazme una página web."

¿Qué resultados obtienes?

El resultado es, invariablemente, genérico y mediocre. Todas las webs creadas con IA en este nivel empiezan a verse igual. Esto se conoce en inglés como "AI slop" : un resultado que funciona, que es funcional, pero que carece de personalidad, de profundidad y de adaptación real a tus necesidades. Cloud Code hace exactamente lo que le pides, pero tu petición es tan pobre que la respuesta no puede ser mejor.

Habilidades a dominar en este nivel

1. Escritura de prompts de calidad.

Aprende a escribir prompts ordenados, coherentes y bien estructurados. Un buen prompt es la base de todo. No se trata de escribir mucho, sino de escribir con intención.

2. Uso básico de la terminal.

Si todavía no lo has hecho, es momento de dar el salto. Descarga Visual Studio Code y empieza a trabajar con Cloud Code dentro de la terminal. Es el primer paso para dejar de ser un usuario casual y empezar a ser un profesional.

El obstáculo principal: el "AI Slop"

La mediocridad de los resultados es lo que frena a las personas en este nivel. Como los resultados no son excelentes, muchos asumen que la herramienta no da para más, cuando en realidad el problema no es la IA, sino la falta de preparación y contexto en el input.

La llave para el Nivel 2

Desbloqueas el nivel dos cuando dejas de tirar instrucciones sueltas y activas el modo plan. Dejas que Cloud Code te haga preguntas antes de construir y empiezas a armar tu espacio de trabajo con una configuración mínima que le dé sentido a la herramienta.

✍️ EJERCICIO PRÁCTICO – NIVEL 1

Objetivo: Toma conciencia de la diferencia entre un prompt pobre y uno estructurado.

1. Prompt en bruto: Abre Cloud Code y escribe exactamente esto: "Hazme una página web para mi negocio." Anota el resultado (copiar y pegar el código o describir el diseño).

2. Prompt mejorado: Ahora, escribe esto: "Quiero una landing page para una agencia de marketing digital. Debe tener: un encabezado con nombre y eslogan, una sección de servicios (3 tarjetas), una sección de testimonios (2 columnas) y un formulario de contacto. Usa colores azul marino y blanco, y que sea responsive." Anota el resultado.

3. Reflexión: Compara ambos resultados. ¿Cuál se acerca más a lo que necesitas? Anota 3 diferencias clave entre ambos prompts.

Bonus: Si aún no lo has hecho, descarga Visual Studio Code y abre la terminal. Ejecuta tu primer comando de Cloud Code desde allí (aunque solo sea para verificar que está instalado).

3. NIVEL 2: EL PLANIFICADOR

Pienso, luego desarrollo

¿Cómo reconocer si estás aquí?

Estás en este nivel cuando empiezas a usar el comando plan antes de abordar tareas complejas. Ya no lanzas código a lo loco. Ahora tu flujo es: planificar primero, implementar después. Además, comienzas a desafiar a Cloud Code en sus decisiones y le pides consejos, en lugar de simplemente aceptar su primera respuesta.

¿Qué es el comando "plan"?

Si no conoces el modo plan, debes saber que existe un comando específico que se encarga de planear absolutamente todo lo que quieres hacer. Para tareas que no son triviales ni sencillas, primero haces un plan y se lo pides a Cloud, y recién luego de tenerlo claro, pasas a la implementación.

Esto te ahorra:

• Errores costosos.

• Tokens (que son valiosos).

• Tiempo (que es aún más valioso).

Cómo se usa en la práctica

Imagina que quieres construir una aplicación para YouTube que analice canales de la competencia y te dé ideas de contenido. Algo complejo, no una simple landing page.

La forma correcta no es pedirle que te lo cree directamente, sino planear con él. Le dices con el comando plan:

"Ayúdame a construir una app de YouTube que analiza la competencia y me da ideas de contenido."

Cloud Code te devolverá un plan detallado que incluye:

• Resumen de lo que va a construir.

• Estructura de carpetas y rutas de archivos.

• Decisiones de diseño y tecnología.

• Formato y decisiones clave.

Tú lees ese plan, lo validas y, solo cuando ves que las funcionalidades son las correctas y es lo que quieres, le das el visto bueno para la implementación. Incluso puedes guardar estos planes en una carpeta para reutilizarlos o revisarlos después.

Habilidades a dominar en este nivel

1. Saber usar el modo plan (plan) correctamente.

2. Hacer preguntas inteligentes sobre el plan.

Si algo no lo entiendes, pregúntale: "Ayúdame a entender por qué esto es necesario en el plan". Cloud tiene contexto del espacio de trabajo y te lo explicará.

3. Aportar tu propio criterio.

No solo digas "hazlo". Da contexto, hazle entender tu visión, tus ideas. No permitas que la IA tome todas las decisiones por ti.

El obstáculo principal: la pasividad

Cuando te acostumbras a que Cloud te haga preguntas y te dé su expertise, es muy fácil caer en la zona de confort y decirle que sí a todo. Debes mantener tu criterio propio. Si Cloud te sugiere algo y tú sabes que no es lo mejor, díselo. El criterio humano sigue siendo irremplazable.

La llave para el Nivel 3

El nivel 3 se desbloquea cuando tomas conciencia de que el contexto es mucho más importante que el prompt y empiezas a gestionar activamente qué información tiene Cloud Code a su disposición.

✍️ EJERCICIO PRÁCTICO – NIVEL 2

Objetivo: Aprender a usar el comando plan y a cuestionar las decisiones de la IA.

1. Planea un proyecto real: Piensa en una tarea no trivial (por ejemplo: "Una app que lleve el control de mis gastos mensuales con categorías y gráficos"). Abre Cloud Code y ejecuta: /plan Ayúdame a construir una app de control de gastos con categorías y gráficos visuales.

2. Lee y analiza: Cloud Code te entregará un plan completo. Léelo de principio a fin. Identifica al menos 3 decisiones de diseño que haya tomado (ej. tecnología, estructura de carpetas, tipo de base de datos).

3. Cuestiona el plan: Elige una de esas decisiones y pregúntale: "No entiendo por qué elegiste [tecnología X] para la base de datos. ¿Podrías explicármelo y darme alternativas?"

4. Toma el control: Decide si aceptas la sugerencia o si prefieres otra opción. Dile: "Mejor usemos [tu alternativa]" y pídele que actualice el plan. Guarda el plan final en una carpeta llamada planes/.

4. NIVEL 3: EL INGENIERO DE CONTEXTO

El contexto es el rey

¿Cómo reconocer si estás aquí?

Llegas a este nivel cuando ya gestionas un espacio de trabajo ordenado con el contexto que necesita ver Cloud Code. Ya no trabajas en el vacío; tienes carpetas estructuradas para el negocio, la estrategia, los proyectos y la información personal.

El poder de un workspace estructurado

Un espacio de trabajo bien configurado incluye, por ejemplo:

• Datos actuales de tu empresa.

• Estrategia: a dónde quieres llevar tu negocio.

• Información personal: qué herramientas usas, cuáles son tus responsabilidades.

• Proyectos activos: qué estás haciendo en el mes o en el año.

Tener este contexto es la diferencia entre una respuesta genérica y una respuesta afilada, precisa y útil. Cloud Code te ayudará de una manera mucho mejor porque te conoce.

El archivo cloud.md: tu manual de instrucciones persistente

El archivo cloud.md (según la documentación oficial de Cloud) contiene instrucciones persistentes para Cloud Code. Se carga al inicio de cada sesión.

¿Qué debe ir en este archivo?

• Convenciones del proyecto.

• Notas importantes de la arquitectura.

• Reglas que siempre se deben cumplir.

• Instrucciones de cómo quieres que trabaje Cloud Code (por ejemplo, que actualice automáticamente el propio archivo cuando crees nuevos proyectos).

Consejo clave: debe ser optimizado y conciso. No lo hagas demasiado largo; solo lo esencial.

Gestión de la ventana de contexto: el "sweet spot"

Un error gravísimo en este nivel es pensar que más contexto da mejores respuestas. Falso. Hay un punto medio, un sweet spot, donde el contexto es suficiente pero no saturado. Si te pasas, el modelo sufre una "degradación por contexto" y la calidad de las respuestas baja drásticamente.

Herramientas para gestionarlo:

• Status bar: puedes pedirle a Cloud Code que te cree una barra de estado que muestre qué tan cargada está la ventana de contexto. Mantente siempre por debajo del 50% de capacidad.

• Comando clear: inicia una nueva sesión y borra todo el contexto previo. Úsalo cuando cambies de tarea para no quemar tokens innecesariamente.

• Comando compact: hace un resumen de la conversación hasta el momento. Cloud Code continuará con ese resumen en lugar de leer todo el historial. No es perfecto y perderás detalles, pero es muy útil en conversaciones largas.

El obstáculo principal: la saturación

Pensar que más información siempre es mejor. Muchos llenan el contexto de basura y terminan saturando al modelo. Sin un espacio de trabajo coherente, Cloud Code no entiende nada y te responde con resultados pobres.

La llave para el Nivel 4

Pasas al nivel cuatro cuando empiezas a conectar Cloud Code con herramientas externas de tu día a día utilizando MCPs (Model Context Protocol).

✍️ EJERCICIO PRÁCTICO – NIVEL 3

Objetivo: Estructurar tu espacio de trabajo y dominar la gestión de contexto.

1. Crea tu workspace desde cero: Crea una carpeta principal. Dentro, genera estas subcarpetas:

o contexto/

o proyectos/

o skills/

o planes/

2. Crea tu archivo cloud.md: Dentro de la raíz, crea el archivo cloud.md y escribe estas 5 reglas mínimas:

o Resumen de la estructura de carpetas.

o Siempre actualiza este archivo cuando crees un nuevo proyecto.

o Usa el comando clear al cambiar de tarea.

o Mantén el contexto por debajo del 50%.

o Escribe código limpio y con comentarios en español.

3. Simula una carga y descarga: Inicia una conversación larga con Cloud Code (pídele que te ayude a refactorizar 3 funciones). Luego de un rato, ejecuta el comando compact y observa cómo resume la charla. Justo después, ejecuta clear y verifica que la memoria se haya vaciado (pregúntale "¿Qué estábamos haciendo?" a ver si lo recuerda).

5. NIVEL 4: LA NAVAJA SUIZA

Conecta con tu ecosistema de trabajo

¿Cómo reconocer si estás aquí?

Estás en este nivel cuando ya empiezas a conectar Cloud Code con herramientas externas: Notion, GitHub, Supabase, etc. Tienes una idea general de qué es un frontend, un backend, autenticaciones y APIs, pero aún te quedan muchas cosas por dominar técnicamente.

¿Qué son los MCPs?

MCP significa Model Context Protocol (en inglés). Es un estándar de código abierto que conecta aplicaciones de inteligencia artificial con sistemas externos. Es el puente que permite a Cloud Code interactuar con tus herramientas favoritas.

Ejemplo práctico con Notion

Si conectas el MCP de Notion, Cloud Code puede:

• Buscar y leer contenido de tus páginas y bases de datos.

• Crear y modificar páginas.

• Consultar y filtrar registros.

Imagina este flujo:

Le dices a Cloud Code: "Dime qué tareas tengo pendientes en Notion". Él llama al MCP, accede a tu base de datos, y te devuelve la lista ordenada exactamente como la tienes. Luego le dices: "Agrega una tarea que diga 'subir video a YouTube'". Cloud Code entra a Notion y la crea automáticamente.

Habilidades a dominar en este nivel

1. Selección inteligente de MCPs.

No conectes 20 MCPs porque sí. Conecta solo aquellos que usas en tu día a día. La calidad y la relevancia mandan sobre la cantidad.

2. Visión general de la arquitectura.

Necesitas entender nociones básicas de frontend, backend, bases de datos y autenticación. No necesitas ser un experto, pero sí tener una visión de conjunto para poder debuggear errores y añadir funcionalidades.

3. Entender el razonamiento de Cloud Code.

No le digas que sí a todo. Pregúntale por qué toma ciertas decisiones. Esto te diferencia de la gran mayoría de usuarios, que solo piden cosas sin entender el porqué.

El obstáculo principal: el exceso de herramientas

Muchos piensan que cuantas más herramientas conecten, mejor. La realidad es que tener 100 herramientas confunde al modelo y degrada la calidad de las respuestas. Es mucho mejor tener 5 herramientas bien configuradas y que realmente uses.

La llave para el Nivel 5

Desbloqueas el nivel cinco cuando empiezas a convertir tus procesos repetibles en skills y workflows reutilizables. Cloud Code pasa a ser tu empleado, haciendo el trabajo tedioso por ti sin que tengas que repetir instrucciones.

✍️ EJERCICIO PRÁCTICO – NIVEL 4

Objetivo: Conectar una herramienta externa real (MCP) y automatizar una acción.

1. Prepara el MCP: Siguiendo la documentación oficial (o las instrucciones del video), conecta el MCP de Notion a tu Cloud Code. (Si no usas Notion, puedes usar el de GitHub para listar tus repositorios o el de Supabase).

2. Consulta externa: Escribe este prompt: "Dime cuáles son las 5 tareas más urgentes que tengo en mi base de datos de Notion." (Asegúrate de tener una base de datos de tareas creada previamente).

3. Acción externa: Ahora, escribe: "Agrega una tarea urgente a mi base de datos de Notion que diga: 'Revisar los KPIs del proyecto X'."

4. Verificación: Abre Notion manualmente y confirma que la tarea se haya creado correctamente.

Obstáculo a evitar: Si te da error, pregúntale a Cloud Code: "¿Qué está fallando en la conexión con Notion?" y deja que él te ayude a debuggear.

6. NIVEL 5: EL CREADOR DE SKILLS

Automatiza tu trabajo y hazlo tuyo

¿Cómo reconocer si estás aquí?

Has investigado qué son las skills, ves lo que hay en el mercado y entiendes que hay personas que crean las suyas propias para adaptarlas a sus necesidades. Ya tienes un setup personalizado que se adapta a tu flujo de trabajo y no le sumas cualquier cosa.

¿Qué es una skill?

Una skill no es más que un archivo Markdown (texto plano) que le explica a Cloud Code cómo realizar una tarea específica o cómo trabajar contigo en un área determinada. Por ejemplo, puedes tener una skill para auditar tu espacio de trabajo y detectar dónde estás malgastando tokens, o una skill para diseño de frontend que aplica buenas prácticas al crear páginas web.

Cómo crear tus propias skills

Existe una skill llamada skill-creator. Cuando la invocas, Cloud Code te guía para crear nuevas skills efectivas. Te hará preguntas como:

• ¿Qué información tiene tu empresa?

• ¿Quieres que incluya el logo en cierto lugar?

• ¿Cuántas diapositivas debe tener una presentación?

• ¿Qué colores debe usar?

Al responder, Cloud Code genera la skill por ti. Luego, solo tienes que llamarla cuando la necesites.

El poder de la concatenación

Lo más potente es que puedes concatenar acciones. Puedes crear una skill que:

1. Se conecte al MCP de Notion.

2. Lea una base de datos.

3. Genere un informe.

4. Envíe un correo electrónico.

La creatividad es el único límite.

Habilidades a dominar en este nivel

1. Análisis y selección de skills.

No acumules skills. Si tienes 10 skills de diseño de páginas web porque las viste en redes sociales, Cloud Code se va a marear y no va a saber cuál elegir.

2. Uso de comandos de Cloud Code.

Investiga la barra de comandos de Cloud Code; hay muchos que la gente desconoce pero que son muy útiles.

3. Creación de skills personalizadas.

Esta es la clave para ponerle tu impronta a la herramienta. Cuando creas tus propias skills, la herramienta se vuelve una extensión de ti mismo.

El obstáculo principal: el exceso de skills

Tener 100 skills genéricas es inútil. Tener 10 skills personalizadas que realmente usas y que te ahorran tiempo es un superpoder. Si tienes skills que no usas, bórralas directamente. La efectividad está en la relevancia, no en la cantidad.

La llave para el Nivel 6

El nivel final se desbloquea cuando dejas de operar en una sola sesión y empiezas a orquestar varios agentes en paralelo. Ya no trabajas tú; decides quién hace el trabajo.

✍️ EJERCICIO PRÁCTICO – NIVEL 5

Objetivo: Crear tu primera skill personalizada y auditar tu colección.

1. Instala la skill base: Pídele a Cloud Code que instale la skill skill-creator (cópiala desde algún repositorio o pídele que la genere). Ejecuta: "Activa skill-creator."

2. Crea tu skill: Usa el creador para hacer una skill llamada generar-informe-diario. Dale estas instrucciones: "Quiero una skill que, al ejecutarla, revise mi base de datos de Notion de tareas, cuente las completadas, las pendientes, y las que están en riesgo, y me dé un resumen en un archivo informe.md dentro de la carpeta proyectos/." Sigue las preguntas guía que te hará Cloud Code.

3. Prueba tu skill: Guarda la skill en la carpeta skills/ y luego ejecútala: "Ejecuta la skill generar-informe-diario." (Puede que necesites ajustarla si no tienes los datos reales; la idea es que el flujo funcione).

4. Limpieza de skills: Abre tu carpeta de skills/. Si tienes skills que descargaste y nunca usaste, elimínalas (o muévelas a una carpeta skills-backup/). Reflexiona: ¿Qué skills realmente te ahorrarían tiempo esta semana?

7. NIVEL 6: EL ORQUESTADOR

Coordina equipos de agentes

¿Cómo reconocer si estás aquí?

Has llegado a la cima. Ya no haces el trabajo manualmente; decides quién lo hace. Puedes abrir varias terminales de Cloud Code en simultáneo y asignar tareas específicas a cada una. Pasas a ser un director de orquesta.

Técnica 1: Múltiples terminales

La forma más simple de trabajar en paralelo es abrir varias terminales. Por ejemplo:

• Terminal 1: "Implementa el plan del agente de outreach."

• Terminal 2: "Implementa el plan del creador de anuncios."

Cada terminal trabaja en su tarea sin interferir con la otra. Esto acelera muchísimo el desarrollo cuando tienes varios frentes abiertos.

Técnica 2: Worktrees (trabajo en paralelo sin conflictos)

Imagina que trabajas en el mismo proyecto, pero quieres que un agente trabaje en el frontend y otro en el backend. Si ambos trabajan sobre los mismos archivos, se van a pisar (como dos personas escribiendo en el mismo papel).

La solución son los worktrees.

Usas el comando --worktree para decirle a Cloud Code en qué parte del proyecto quieres que trabaje y en qué rama. Por ejemplo:

• Terminal 1: --worktree sales frontend

• Terminal 2: --worktree sales backend

Cada agente trabaja en su propia rama aislada. Cuando ambos terminan, haces un merge y el trabajo se une perfectamente sin conflictos.

Técnica 3: Agent Teams (el nivel más avanzado)

Esta funcionalidad es experimental según la documentación oficial de Cloud Code. Está deshabilitada por defecto y consume muchos más tokens, así que debe usarse con cuidado.

¿Cómo funciona?

Tienes un agente líder que coordina el trabajo. Debajo de él, tienes varios subagentes (por ejemplo, uno de backend, uno de frontend y uno de diseño). Todos los subagentes se comunican entre sí, pero solo el líder se comunica contigo. El líder te da las actualizaciones y noticias.

Casos de uso ideales:

• Investigación y revisión de código.

• Nuevos módulos o funciones complejas.

• Depuración con hipótesis contrapuestas.

Advertencia: el consumo de tokens es altísimo. No lo uses para tareas pequeñas como una web simple; reserva este nivel para proyectos grandes y complejos.

Habilidades a dominar en este nivel

1. División de tareas en múltiples terminales. (Nivel 6.1)

2. Uso de worktrees para trabajar sin pisarse. (Nivel 6.2)

3. Configuración y uso de Agent Teams. (Nivel 6.3)

El obstáculo principal: saltarse las bases

Si no has dominado los niveles del 1 al 5, el nivel 6 te será completamente inútil. La orquestación avanzada requiere que entiendas cómo funciona el contexto, cómo hacer buenos planes, cómo conectar herramientas y cómo crear skills. Saltarse pasos es la receta del fracaso.

✍️ EJERCICIO PRÁCTICO – NIVEL 6

Objetivo: Orquestar agentes en paralelo sin pisarse.

1. Doble terminal: Abre dos terminales en Visual Studio Code dentro del mismo proyecto (por ejemplo, un proyecto web llamado mi-app).

2. Tarea dividida: En la Terminal 1, ejecuta: --worktree mi-app frontend y luego pide: "Implementa la página de inicio con el diseño que tenemos en cloud.md." En la Terminal 2, ejecuta: --worktree mi-app backend y pide: "Crea el endpoint de autenticación de usuarios."

3. Ejecución en paralelo: Deja que ambos agentes trabajen durante unos minutos. Observa cómo Cloud Code crea ramas separadas.

4. Fusión: Cuando ambos terminen, pídele al agente principal (o hazlo tú manualmente) que haga un merge de ambas ramas para integrar el trabajo.

5. (Avanzado - opcional): Si te sientes valiente, instala la funcionalidad experimental de Agent Teams (siguiendo la documentación) y lanza un equipo de 3 agentes para una tarea de refactorización. Mide cuántos tokens consume en comparación con hacerlo en una sola terminal.

8. CASO DE ESTUDIO: "NEXUS CREATIVO"

De la idea a la ejecución en 6 niveles

Contexto del caso

Manuel es el dueño de Nexus Creativo, una agencia de contenido digital que maneja las redes sociales y la estrategia de contenido de 5 clientes importantes. Su principal dolor de cabeza es que dedica más de 10 horas a la semana a tareas repetitivas: revisar manualmente las métricas de YouTube de sus clientes, buscar ideas de contenido en tendencia y redactar los briefs para su equipo de creadores.

Manuel sabe usar ChatGPT, pero siente que los resultados son genéricos. Ha oído hablar de Cloud Code y quiere usarlo para recuperar su tiempo y escalar su agencia.

________________________________________

🟢 Nivel 1 (El Prompteador) – El punto de partida de Manuel

Manuel abre la aplicación de escritorio de Cloud Code y escribe: "Hazme un análisis de los últimos videos de mi cliente y dame ideas para el próximo."

Resultado: Cloud Code le devuelve un texto genérico con consejos típicos de marketing ("haz videos cortos, usa llamadas a la acción"). No hay datos reales, no hay estructura, y las ideas son tan genéricas que no sirven para su cliente. Manuel se frustra.

Lección aprendida: Manuel comprende que tirar prompts a lo loco no funciona. Necesita estructura.

🟡 Nivel 2 (El Planificador) – Manuel se organiza

Manuel decide planificar antes de actuar. Abre Visual Studio Code, la terminal de Cloud Code y escribe:

/plan Quiero construir un sistema que analice los canales de YouTube de mis 5 clientes, extraiga los videos con mejor rendimiento y genere 5 ideas de contenido nuevas basadas en las tendencias actuales. El sistema debe generar un archivo de reporte por cada cliente.

Resultado: Cloud Code le entrega un plan de 15 páginas donde define:

• La estructura de carpetas (clientes/, reportes/, data/).

• Las APIs necesarias (YouTube Data API).

• La tecnología (Python + Flask para el backend, HTML/CSS para el frontend).

• Las bases de datos (SQLite para guardar histórico).

Manuel revisa el plan, le hace preguntas ("¿Por qué SQLite y no MongoDB?"), aporta su criterio ("Mejor usemos PostgreSQL porque ya lo conozco"), y da el visto bueno. Ahora sabe exactamente qué va a construir.

🟠 Nivel 3 (El Ingeniero de Contexto) – Manuel le da identidad a su workspace

Manuel crea su espacio de trabajo con esta estructura:

text

/nexus-creativo

/contexto

• negocio.md (misión, visión, valores de la agencia)
• clientes.md (lista de 5 clientes, sus nichos, tono de voz, audiencia objetivo)
• estrategia.md (objetivos trimestrales)

/proyectos

/analisis-youtube (código de la app)

/skills

/planes

• plan-sistema-youtube.md

Dentro del archivo cloud.md, Manuel escribe:

markdown

# Instrucciones para Cloud Code

1. Contexto de negocio: La agencia Nexus Creativo maneja clientes de nichos variados. Siempre debes considerar el tono de voz específico de cada cliente.

2. Reglas de proyecto: Todos los reportes generados deben guardarse en `reportes/` con el formato `YYYY-MM-DD-cliente-nombre.md`.

3. Gestión de contexto: Si la conversación supera el 50% de uso de contexto, avísame para que ejecute `clear` o `compact`.

4. Actualización: Siempre que añada un nuevo cliente o proyecto, actualiza este archivo automáticamente.

Resultado: Ahora Cloud Code sabe quién es Manuel, qué hace su agencia y cómo quiere trabajar. Las respuestas empiezan a ser mucho más afinadas.

🔵 Nivel 4 (La Navaja Suiza) – Manuel conecta todo su ecosistema

Manuel conecta los siguientes MCPs a su Cloud Code:

• YouTube Data API MCP: Para extraer métricas de los canales de sus clientes (vistas, likes, comentarios, duración promedio).

• Notion MCP: Para leer la base de datos donde lleva el calendario editorial de sus clientes.

• Google Sheets MCP: Para exportar los datos históricos y hacer gráficos de evolución.

Ahora, Manuel puede escribir:

"Conéctate a YouTube, tráeme los 3 videos más vistos del cliente 'TechCorp' en el último mes, y añádelos como una tabla en la página de Notion que se llama 'Análisis TechCorp'."

Resultado: Cloud Code hace todo el trabajo pesado en segundos. Manuel solo valida la información. El tiempo de extracción de datos baja de 2 horas a 5 minutos.

🟣 Nivel 5 (El Creador de Skills) – Manuel automatiza su flujo estrella

Manuel usa la skill skill-creator para construir una skill llamada: generar-brief-semanal.

Manuel le dice a Cloud Code:

"Quiero que esta skill haga lo siguiente en orden:

1. Toma el nombre del cliente que le pase como parámetro.

2. Ve a YouTube y extrae las métricas de sus últimos 5 videos.

3. Ve a mi Notion y extrae los temas que ya hemos cubierto este mes.

4. Con esos datos, genera un brief de contenido con 5 ideas nuevas, asegurándote de que no repitan temas.

5. Guarda el brief en la carpeta reportes/ con el nombre del cliente y la fecha."

Cloud Code le genera la skill en Markdown. Manuel la prueba con su cliente 'EcoStore'. La skill funciona a la perfección y le ahorra 3 horas de trabajo.

Limpieza: Manuel revisa su carpeta de skills y elimina 3 skills genéricas que descargó de internet y nunca usó. Se queda solo con las que realmente necesita.

⚫ Nivel 6 (El Orquestador) – Manuel escala su agencia

Manuel necesita generar los briefs semanales para sus 5 clientes. En lugar de hacerlos uno por uno, abre 5 terminales en Visual Studio Code.

• Terminal 1: "Ejecuta la skill generar-brief-semanal para el cliente TechCorp."

• Terminal 2: "Ejecuta la skill generar-brief-semanal para el cliente EcoStore."

• Terminal 3: "Ejecuta la skill generar-brief-semanal para el cliente FitLife."

• Terminal 4: "Ejecuta la skill generar-brief-semanal para el cliente GourmetBox."

• Terminal 5: "Ejecuta la skill generar-brief-semanal para el cliente EduFuture."

Todas las terminales trabajan en paralelo. Manuel se toma un café.

Resultado: En 10 minutos, los 5 briefs están listos en la carpeta reportes/. Adicionalmente, como un experimento avanzado, Manuel usa un worktree para que un agente trabaje en mejorar el frontend de la app de análisis, mientras otro agente optimiza las queries de la base de datos, sin que se pisen entre sí.

📈 Resultado Final del Caso de Estudio

• Tiempo invertido antes: 10+ horas semanales.

• Tiempo invertido después: 30 minutos (10 min de ejecución + 20 min de revisión y ajuste fino).

• Calidad: Los briefs ahora están basados en datos reales, son personalizados para cada cliente y no repiten temas.

• Escalabilidad: Manuel puede tomar 5 clientes más sin contratar a nadie, porque el sistema está automatizado.

Conclusión de Manuel:

"Cloud Code no es solo una IA que escribe código. Es un ecosistema que, si lo estructuras bien, se convierte en el miembro más productivo de mi equipo. Pasé de escribir prompts a diseñar flujos de trabajo, y eso cambió mi negocio por completo."

9. EPÍLOGO

El viaje no termina aquí

Cloud Code evoluciona cada semana. Nuevas funcionalidades y herramientas aparecerán constantemente. Pero si tienes este mapa en la cabeza (los 6 niveles), nunca perderás el norte. Sabrás exactamente en qué nivel estás, qué te falta por dominar y qué acción tomar para dar el siguiente paso.

Recuerda: la herramienta es poderosa, pero el verdadero poder reside en tu capacidad para estructurar, planificar, contextualizar, conectar, automatizar y orquestar.

Bienvenido al camino del orquestador.

10. APÉNDICE A: GLOSARIO DE TÉRMINOS

• AI Slop: Resultados mediocres y genéricos que da la IA cuando el input es pobre.

• Cloud.md: Archivo de instrucciones persistentes que se carga al inicio de cada sesión de Cloud Code.

• Compact: Comando que resume una conversación larga para ahorrar contexto.

• Clear: Comando que inicia una nueva sesión y borra el contexto previo.

• Contexto: Toda la información que Cloud Code tiene disponible para responder.

• Degradación por contexto: Pérdida de calidad en las respuestas cuando el contexto está saturado.

• MCP (Model Context Protocol): Estándar que conecta IA con sistemas externos.

• Plan: Comando para generar un plan detallado antes de implementar.

• Skill: Archivo Markdown que le enseña a Cloud Code a hacer una tarea específica.

• Worktree: Mecanismo para trabajar en ramas aisladas dentro de un mismo proyecto.

• Agent Team: Equipo experimental de agentes coordinados por un líder.

11. APÉNDICE B: HOJA DE REFERENCIA RÁPIDA (COMANDOS)

Comando Función

/plan Genera un plan detallado antes de la implementación.

clear Borra el contexto y empieza una sesión nueva.

compact Resume la conversación actual para ahorrar tokens.

--worktree [proyecto] [área] Crea una rama aislada para trabajar en paralelo.

skill-creator Invoca la skill que te guía para crear nuevas skills.

2. APÉNDICE C: PLANTILLAS DESCARGABLES

📄 Plantilla 1: cloud.md

markdown

# Instrucciones para Cloud Code

Contexto del proyecto

[Breve descripción de quién eres y qué haces]

Estructura de carpetas

• `/contexto`: Información de negocio, clientes, estrategia.
• `/proyectos`: Código de los proyectos activos.
• `/skills`: Skills personalizadas.
• `/planes`: Planes generados con `/plan`.

Reglas de trabajo

1. Siempre actualiza este archivo cuando crees un nuevo proyecto.

2. Usa el comando `clear` al cambiar de tarea.

3. Mantén el contexto por debajo del 50% (avísame si superamos ese límite).

4. Escribe código limpio y con comentarios en español.

5. [Añade tus propias reglas]

Tecnologías preferidas

[Lista de tecnologías que prefieres usar]

📄 Plantilla 2: Estructura de Skill

markdown

# [Nombre de la skill]

Descripción

[Breve descripción de lo que hace la skill]

Instrucciones

1. [Paso 1]

2. [Paso 2]

3. [Paso 3]

[...]

Parámetros (opcional)

• `[parámetro1]`: [descripción]
• `[parámetro2]`: [descripción]

Ejemplo de uso

`Ejecuta la skill [nombre] con el parámetro [X].`

Notas

[Cualquier nota adicional, advertencia o consejo]

📄 Plantilla 3: Estructura de Workspace

text

/mi-workspace

/contexto

• negocio.md
• clientes.md
• estrategia.md
• personal.md

/proyectos

/proyecto-1

/proyecto-2

/skills

• skill-1.md
• skill-2.md

/planes

• plan-proyecto-1.md
• plan-proyecto-2.md

/reportes

• reporte-YYYY-MM-DD.md

cloud.md

README.md