PTENES
MÓDULO 1.3

📖 Glosario esencial (Parte 1: IA, Claude Code, n8n)

El diccionario de campo del vibe coding. Aquí cada tema es un grupo de términos definido con un ejemplo concreto — desde los conceptos de IA hasta los modos del asistente, los archivos clave, MCP y los nodos de n8n. Consúltalo de principio a fin o ve directamente al grupo que necesitas. Nada de jerga sin explicar: todo viene con su traducción.

7
Clusters
~50
Minutos
Básico
Nivel
Glosario
Tipo
Progreso del módulo 0% · 0 de 7

🌱 ¿Nuevo por aquí?

Este módulo es una referencia: no necesitas memorizarlo todo de una vez. Cada término viene con una definición breve e un ejemplo concreto, porque una definición sin ejemplo se recuerda menos. Usa el índice de la derecha para saltar al grupo que necesitas — y vuelve cada vez que encuentres una palabra nueva en las otras rutas.

Los siete clusters siguen el flujo de quien está empezando: primero las ideas de IA, después cómo hablar con el asistente (modos), luego los archivos donde se configura todo, después cómo conectar herramientas (MCP) y, por último, n8n —desde lo básico hasta la IA— y los bloques de datos que alimentan las respuestas.

🧠 Conceptosde IA 🎛️ Modosdel asistente 🗂️ Archivos-clave 🔌 MCPherramientas 🔗 n8nbásico 🤖 n8ncon IA 📊 Datosque alimentan las respuestas

Diagrama ilustrativo — los grupos del glosario en orden de aprendizaje. Cada cuadro es un tema a continuación, con sus términos definidos.

1

🧠 Conceptos de IA

Qué es

Este grupo es el alfabeto de la IA. Antes que nada: LLM (large language model, «modelo de lenguaje grande») es el tipo de IA que entiende y genera texto; es el «motor» detrás del asistente. Hablas con él por medio de un prompt: el mensaje que escribes. Encima de cada conversación está el system prompt, una instrucción de fondo (rol, contexto, reglas) que se aplica a toda la sesión.

Todo lo que el LLM «ve» en ese momento es el contexto (o context window, «ventana de contexto») — el espacio de memoria de la conversación. Ese espacio se mide en tokens: fragmentos de palabras que cuenta la IA. Y hay un efecto que debes temer: el context rot ("deterioro del contexto"), la caída de calidad cuando la ventana se llena de historial y el modelo empieza a equivocarse más.

GlosarioConceptos de IA

LLM
IA que entiende y genera texto. Ej.: escribes "resume este correo" y te devuelve el resumen.
Prompt
El mensaje que envías. Ej.: «crea un workflow que revise el correo electrónico cada 10 min».
System prompt
Instrucción de fondo de la sesión (rol, reglas). Ej.: «eres mi asistente de workflows de n8n».
Contexto / context window
Todo lo que la IA ve ahora (la memoria de la conversación). Ej.: los archivos y mensajes ya intercambiados.
Token
Fragmento de palabra que cuenta la IA; las conversaciones largas consumen más. Ej.: «automatización» ≈ algunos tokens.
Context rot
Caída de calidad cuando la ventana se llena. Ej.: después de mucho historial, la IA olvida una regla inicial.

Por qué aprender

Estos seis términos explican por qué el asistente a veces «olvida» o se equivoca: la conversación creció, la ventana se llenó, el contexto se deterioró. Saberlo te da el reflejo correcto: iniciar sesiones enfocadas y limpiar el contexto antes de que baje la calidad (aprendes cómo hacerlo en los modos, más adelante).

Conceptos clave

LLM

El motor que genera texto.

Prompt

Tu mensaje.

Contexto

La memoria de la conversación.

Token

La unidad de lo que lee.

2

🎛️ Modos del asistente

Qué es

El asistente tiene modos de permiso que controlan cuánto actúa por su cuenta. El plan mode (modo de planificación) es donde investiga, hace preguntas y propone un plan antes de cambiar algo: primero tú lo apruebas. En el otro extremo, el bypass permissions ("omitir permisos") le permite actuar sin pedir aprobación en cada paso: es rápido, pero dejas de ver lo que hace, así que úsalo con cuidado.

Para gestionar el contexto (que viste deteriorarse), hay dos comandos: /clear reinicia toda la conversación — úsalo al cambiar de tarea o cuando la calidad baje; /compact hace un resumen inteligente, conservando lo esencial y comprimiendo el resto; úsalo a mitad de una tarea cuando el contexto se hace extenso.

GlosarioModos y comandos

Plan mode (modo de planificación)
Investigación + preguntas + plan, antes de ejecutar. Ej.: describes la meta y revisas su plan.
Permission modes (modos de permisos)
Cuánto actúa el asistente por su cuenta: preguntar antes, editar automáticamente, plan, auto. Ej.: «preguntar antes de editar».
Bypass permissions
Omite la aprobación en cada paso; es veloz, pero pierdes visibilidad. Ej.: activado para una compilación larga ya aprobada.
/clear
Restablece la conversación desde cero. Ej.: al cambiar de proyecto o cuando empieza a cometer errores.
/compact
Resumen inteligente: conserva lo que importa. Ej.: en medio de una tarea larga, cerca de ~70% del contexto.

Por qué aprender

Estos comandos son tu «embrague». Empezar en plan mode evita que la IA construya algo equivocado; /compact e /clear mantienen la calidad alta y el costo de tokens bajo. La regla práctica: piensa en compactar cuando el contexto esté cerca del 70% y en limpiar al superar el 85% o al cambiar de tarea.

✓ Buen uso de los modos

  • ✓Empezar en plan mode para tareas que no sean triviales.
  • ✓/compact a mitad de camino; /clear al cambiar de tarea.
  • ✓Bypass solo después de aprobar el plan.

✗ Qué evitar

  • ✗Bypass desde el inicio, sin ver qué hace.
  • ✗Reutilizar una conversación sobrecargada para algo nuevo.
  • ✗Insistir en un contexto degradado en vez de limpiarlo.

Conceptos clave

Plan mode

Planifica antes de actuar.

Bypass

Rápido, pero a ciegas.

/clear

Restablecimiento total.

/compact

Resumen inteligente.

3

🗂️ Archivos clave

Qué es

Un proyecto de vibe coding gira en torno a algunos archivos. El más importante es el CLAUDE.md: un system prompt persistente, escrito en markdown, que define quién es el asistente, qué construyes y cuáles son tus preferencias; se lee en cada sesión. El .env guarda los secretos (claves de API), y el .gitignore enumera qué nunca debe subirse a la nube — y el .env siempre está en esta lista.

Para conectar herramientas, existe el .mcp.json: el archivo que registra los servidores MCP del proyecto (pero la clave en sí queda en el .env, nunca aquí). Y cuando empaquetas una instrucción reutilizable, se convierte en un SKILL.md dentro de la carpeta de skills: el "manual" de esa skill.

GlosarioArchivos del proyecto

CLAUDE.md
System prompt persistente en markdown (rol, contexto, reglas, estilo). Ej.: «eres mi asistente de n8n; sé conciso».
.env
Archivo de secretos (claves de API), fuera del código. Ej.: la clave de n8n y la URL de la instancia están aquí.
.gitignore
Lista de lo que no se sube a GitHub. Ej.: el .env entra aquí para que la clave nunca se filtre.
.mcp.json
Registro de los servidores MCP del proyecto (sin la clave). Ej.: la entrada del server + un espacio reservado para una clave.
SKILL.md
El «manual» de una skill (nombre, descripción, argumentos, pasos). Ej.: la skill /rascunhar-email.

Por qué aprender

Conocer estos archivos es saber dónde está cada cosa: reglas de sesión en CLAUDE.md, secretos en el .env, herramientas en el .mcp.json, skills en SKILL.md. Eso evita el error más peligroso de los principiantes: pegar una clave de API en el lugar equivocado (en el chat o en el .mcp.json) y exponerla.

🎯 Consejo práctico

Regla de oro de los secretos: la clave de API solo entra en el .env — nunca en el chat, nunca en el .mcp.json, nunca confirmada con commit. El .gitignore garantiza que el .env no la subas. Trata una clave como el acceso a una tarjeta de crédito.

Conceptos clave

CLAUDE.md

Reglas para todas las sesiones.

.env

Solo aquí van los secretos.

.gitignore

Lo que no se despliega.

.mcp.json

Registra herramientas.

4

🔌 MCP

Qué es

MCP (Model Context Protocol) es el protocolo que conecta el asistente con herramientas externas. Quien proporciona esas herramientas es un MCP server — un programita que expone un conjunto de acciones. Cada acción es una tool (herramienta): enviar correos, extraer datos de un sitio web, leer una base de datos. Una vez conectados, el asistente conoce todas las tools de ese server y decide cuál llamar.

No necesitas inventar servers desde cero: existe la descubrimiento de servers — directorios de MCP y repositorios públicos donde se encuentran servidores listos por categoría (scraping web, bases de datos, documentos, comunicación). Para instalar, suele bastar con pedirle al asistente que lo configure y pegar la clave en el .env y reiniciar.

GlosarioMCP y herramientas

MCP (Model Context Protocol)
El estándar que conecta el asistente con herramientas externas. Ej.: conectar el asistente a tu n8n.
MCP server
El programa que expone las acciones de un servicio. Ej.: un server de scraping web; un server de n8n.
Tool (herramienta)
Cada acción que ofrece el server. Ej.: «enviar correo electrónico», «buscar mensajes», «crear workflow».
Descubrimiento de servers
Encontrar servers listos en directorios/repositorios. Ej.: buscar "MCP server" + el nombre del servicio.
Project-level vs global
Dónde se configura el server. Por proyecto es lo recomendado (más seguro).

Por qué aprender

MCP es lo que transforma al asistente de «escritor de texto» en «hacedor de cosas en el mundo». Sin él, nada de enviar correos, rastrear la web o construir en n8n. Entender server × tool ayuda a pedir la herramienta adecuada y a recordar que cada server conectado consume contexto, así que desconecta los que no uses.

Conceptos clave

Protocolo

El idioma común.

Server

Expone las acciones.

Tool

Una acción.

Por proyecto

Más seguro que global.

5

🔗 n8n básico

Qué es

En n8n, el bloque básico es el nodo (node): una cajita que hace un trabajo. Todo flujo empieza con un trigger (disparador): el nodo que activa el flujo — por horario, al llegar un correo o cuando ocurre un evento. Toda la secuencia de nodos, desde el disparador hasta la acción final, es el workflow.

Para que un nodo acceda a una app (Gmail, Sheets…), necesita una credential (credencial): la autorización guardada en n8n. La forma más común de autorizar es el OAuth2 — un «inicio de sesión delegado» en el que accedes a tu cuenta de Google y concedes acceso, sin darle tu contraseña a n8n.

⚡ Triggeractiva el workflow 🔧 Nodohace un trabajo 📤 Acciónguarda / envía 🔐 Credential (OAuth2)autoriza la app externa 📨 App (Gmail…)

Diagrama ilustrativo — el disparador inicia, los nodos ejecutan, y la credencial (autorizada mediante OAuth2) es lo que le da al nodo acceso a la app externa.

GlosarioBloques de n8n

Nodo (node)
Una cajita que hace un trabajo. Ej.: un nodo que lee Gmail; otro que guarda en una hoja de cálculo.
Trigger (disparador)
El nodo que activa el flujo. Ej.: «cada 15 min» o «cuando llegue un correo electrónico».
Workflow
La secuencia completa de nodos. Ej.: activador → filtro → acción → guarda.
Credential (credencial)
La autorización guardada para acceder a una app. Ej.: la credencial de Gmail.
OAuth2
Inicio de sesión delegado: autorizas sin dar la contraseña. Ej.: «iniciar sesión con Google» y conceder acceso.

Por qué aprender

Estos cinco términos son el vocabulario mínimo para entender (y pedir) cualquier automatización. Hay un detalle que ahorra dolores de cabeza: el asistente construye los nodos, pero credenciales (OAuth2) tienes que configurarlo manualmente — es la parte que no hace por ti.

Conceptos clave

Nodo

Haz un trabajo.

Trigger

Activa el flujo.

Credential

Lo configuras manualmente.

OAuth2

Inicio de sesión sin dar la contraseña.

6

🤖 n8n con IA

Qué es

n8n tiene nodos que integran IA en el flujo. El AI agent node es el nodo que se convierte en un miniagente: recibe una instrucción (system prompt), puede usar herramientas y responde con razonamiento. El text classifier ("clasificador de texto") etiqueta una entrada en categorías —útil para enrutar antes de gastar en el agente caro (p. ej.: "¿esto es soporte técnico o no?").

Para lógica a medida existe el code node ("nodo de código"): un nodo donde se ejecuta un pequeño fragmento de código (que escribe el asistente) para transformar datos: extraer un nombre, armar un texto, activar una señal. Y para decisiones simples de sí o no está el IF node, que bifurca el flujo: si la condición es verdadera, sigue por un camino; si no, por otro.

GlosarioNodos de IA y lógica

AI agent node
Nodo que razona, usa herramientas y responde. Ej.: lee la pregunta, consulta la base y redacta la respuesta.
Text classifier
Clasifica la entrada en categorías para enrutarla. Ej.: «soporte» vs. «no relevante» — omite lo que no sea soporte.
Code node
Ejecuta un fragmento de código (escrito por el asistente) para transformar datos. Ej.: extraer el nombre de una suscripción.
IF node
Divide el flujo según una condición de sí/no. Ej.: «¿encontraste la política?» → si sí, redacta; si no, pide investigar.

Por qué aprender

Combinar estos nodos es el corazón de un agente útil: el classifier filtra desde el principio (ahorra), el IF decide los caminos, el code node ajusta los datos y el AI agent hace el trabajo de pensar. Saber el papel de cada uno te ayuda a entender lo que configuró el asistente y a pedir mejoras específicas.

✓ Buen diseño con estos nodos

  • ✓Clasificar pronto para no activar al agente innecesariamente.
  • ✓Usar IF para manejar caminos (encontró / no encontró).
  • ✓Code node para extraer/transformar datos puntuales.

✗ Señales de problemas

  • ✗Enviarle todo directamente al agente (caro y lento).
  • ✗Olvidar el camino «no» del IF (el flujo muere en silencio).
  • ✗Confiar en el "verde" sin revisar la salida real.

Conceptos clave

AI agent

Piensa y usa herramientas.

Classifier

Clasifica y enruta.

Code node

Transforma datos.

IF node

Divide el flujo.

7

📊 Datos

Qué es

Para que la IA responda con base en los tus documentos, necesitan convertirse en datos que se puedan consultar. El vector store ("almacén de vectores") es una base de datos especial que guarda el significado de los textos para buscar por sentido, no solo por palabra exacta. Ese "significado en números" son los embeddings: la representación numérica de un fragmento de texto.

Antes de almacenar, dos pasos preparan los documentos. El document loader ("cargador de documentos") lee el archivo y extrae el texto. El text splitter ("divisor de texto") divide ese texto en fragmentos del tamaño adecuado, porque buscar y recuperar funciona mejor con fragmentos que con un documento gigante completo.

GlosarioBloques de datos

Vector store
Base de datos que busca por significado, no por palabra exacta. Ej.: encuentra la política de garantía incluso sin la palabra «garantía».
Embeddings
El significado de un texto convertido en números. Ej.: los fragmentos parecidos quedan "cerca" en este espacio numérico.
Document loader
Lee el archivo y extrae el texto. Ej.: abrir un PDF de políticas y extraer el contenido.
Text splitter
Divide el texto en fragmentos que se puedan buscar. Ej.: dividir el PDF en fragmentos por sección.

Por qué aprender

Estos cuatro bloques son la base de RAG (que verás en el módulo 1.4): en vez de que la IA «adivine», consulta tus documentos y responde con base en ellos — y se niega a inventar cuando el dato no está ahí. Es lo que distingue a un agente confiable de uno que alucina.

La ventana de contexto se llenó de historial y la IA empezó a equivocarse más. ¿Cómo se llama este efecto?

Conceptos clave

Vector store

Busca por significado.

Embeddings

Significado en números.

Loader

Lee el documento.

Splitter

Divídelo en fragmentos.

📌 Resumen del módulo

✓
Conceptos de IA — LLM, prompt, system prompt, contexto/ventana, token, context rot.
✓
Modos del asistente — modo plan, modos de permisos, bypass, /clear, /compact.
✓
Archivos clave — CLAUDE.md, .env, .gitignore, .mcp.json, SKILL.md.
✓
MCP — MCP, servidor MCP, tool, descubrimiento de servers, por proyecto vs. global.
✓
n8n básico — nodo, trigger, workflow, credential, OAuth2.
✓
n8n con IA + Datos — AI agent, classifier, code node, IF; vector store, embeddings, loader, splitter.

Siguiente módulo:

1.4 — Glosario esencial (parte 2: agéntico, RAG, deploy, seguridad)