93 términos · español e inglés

Glosario

Cada término en una o dos frases sencillas. El mismo texto se abre cuando tocas una palabra subrayada con puntos en cualquier página.

Lo básico

archivo file: Un contenido con nombre guardado en tu equipo, como un documento, una imagen o un trozo de código.
carpeta folder: Un contenedor de archivos y otras carpetas. Cada proyecto vive en su propia carpeta.
carpeta personal home folder: Tu carpeta propia en el equipo, que se escribe ~. En Mac lleva tu nombre; en Windows es C:\Users\<nombre>.
archivo oculto hidden file: Un archivo cuyo nombre empieza por un punto, como .env.local. Tu equipo lo oculta por defecto (Mac: Cmd + Mayús + . en Finder; Windows: Vista → Mostrar → Elementos ocultos).
ruta (path) path: La dirección de un archivo o carpeta en tu equipo, que muestra las carpetas que abres para llegar a él separadas por barras.
terminal terminal: Una ventana donde escribes comandos en lugar de hacer clic. Tu agente suele usarla por ti.
comando command: Una instrucción que se escribe en la terminal, como git --version. Tu agente explica cada una antes de ejecutarla.

Git y GitHub

repositorio (repo) repo (repository): La carpeta de tu proyecto más todo su historial. Git registra cada punto de guardado para que puedas volver a cualquier versión.
Git Git: La herramienta que guarda la memoria de tu repositorio: registra cada commit en tu equipo.
commit commit: Un punto de guardado: una foto de lo que cambió, con una nota corta. Puedes volver a cualquier commit.
rama branch: Una copia segura de tu proyecto donde se preparan los cambios. main es la publicada.
main main: La rama principal. Lo que hay en main es lo que muestra tu web publicada.
fusionar (merge) merge: Llevar los cambios de una rama a otra, normalmente a main una vez aprobados.
pull request pull request: Una propuesta de cambios para fusionar una rama, que GitHub muestra con sus cambios y comprobaciones para que la revises antes.
push (subir) push: Enviar tus commits desde tu equipo a GitHub.
pull (traer) pull: Traer cambios desde GitHub a tu equipo.
clonar (clone) clone: Copiar un repositorio desde GitHub a un equipo por primera vez, con todo su historial.
remoto remote: El gemelo de tu repositorio que vive en GitHub. El local vive en tu equipo.
.gitignore .gitignore: Un archivo con lo que Git nunca debe guardar, como node_modules y tus archivos secretos .env.

La web

frontend frontend: La parte de una app que funciona en el navegador de quien la visita: lo que se ve y se pulsa.
backend backend: La parte de una app que funciona en un servidor: guarda datos, comprueba inicios de sesión y habla con otros servicios.
navegador browser: El programa con el que se abren las páginas web, como Safari, Chrome, Edge o Firefox.
servidor server: Un equipo conectado a internet que ejecuta tu backend y envía páginas o datos cuando un navegador los pide.
URL URL: La dirección web completa de una página o un endpoint, como https://my-first-app.vercel.app/recipes.
HTTPS HTTPS: La versión segura de una conexión web: cifra los datos entre el navegador y el servidor para que nadie en medio pueda leerlos.
dominio domain: Una dirección web que se puede escribir, como agenticmakers.app.
localhost localhost: Tu propio equipo haciendo de servidor mientras pruebas, normalmente en http://localhost:3000.
puerto port: Una puerta numerada del equipo en la que escucha una app, como la 3000. Solo una app puede usar cada puerto a la vez.
API API: La forma acordada en que dos programas hablan entre sí, como tu app pidiendo una respuesta a un proveedor de IA.
endpoint endpoint: Una dirección concreta de una API o de tu backend que hace una tarea específica, como guardar un formulario o responder una petición.
JSON JSON: Un formato de texto ordenado con llaves y pares clave-valor que usan los programas para intercambiar datos y guardar logs estructurados.

Construir

framework framework: Una base ya hecha para construir apps. Agentic Makers usa Next.js.
Next.js Next.js: El framework web que usa esta guía: combina tus pantallas en React (frontend) y la lógica de servidor (backend) en un mismo proyecto.
React React: La biblioteca que usa Next.js para construir pantallas a partir de piezas reutilizables llamadas componentes, como botones, tarjetas y formularios.
componente component: Una pieza reutilizable e independiente de la interfaz de tu app, como una barra de navegación, una tarjeta de receta o un botón de envío.
paquete (dependencia) package (dependency): Código ya hecho que usa tu app. npm instala los paquetes en la carpeta node_modules.
npm npm: El gestor de paquetes que viene con Node.js: instala paquetes y ejecuta los comandos de tu proyecto, como npm run dev.
npx npx: Una herramienta compañera de npm que ejecuta un paquete de línea de comandos directamente sin instalarlo de forma permanente en tu equipo.
Node.js Node.js: El programa que permite a tu equipo ejecutar JavaScript y TypeScript fuera del navegador, y que hace funcionar Next.js y tus herramientas de desarrollo.
TypeScript TypeScript: JavaScript con etiquetas que indican qué tipo de dato espera cada pieza (texto, número, lista), para detectar fallos antes de ejecutar la app.
lint lint: Una revisión automática que analiza tu código en busca de descuidos habituales, fallos de accesibilidad y errores de estilo antes de publicar.
comprobación de tipos type check: Pasar TypeScript por todo el proyecto para verificar que cada función, componente y llamada a la base de datos recibe los datos con la forma que espera.
test test: Un pequeño programa que comprueba que tu app hace lo que debe, para que un arreglo no se rompa sin avisar más adelante.

Datos

base de datos database: Donde tu app recuerda cosas entre visitas, como cuentas o recetas guardadas.
Postgres Postgres: PostgreSQL: el motor de base de datos de código abierto que organiza los datos de tu app en tablas con filas y columnas.
Neon Neon: El servicio en la nube del stack por defecto que aloja tu base de datos Postgres, se conecta con Vercel y permite crear ramas aisladas de base de datos.
tabla table: Una colección dentro de una base de datos, con forma de hoja de cálculo: columnas para los campos y una fila por cada elemento.
consulta (query) query: Una pregunta o instrucción que tu backend envía a la base de datos, como pedir los elementos guardados de un usuario o insertar una fila nueva.
migración migration: Un archivo de paso registrado que crea o actualiza tablas y columnas en tu base de datos para que su estructura vaya a la par con tu código.
rama de base de datos database branch: Una copia aislada de tu base de datos creada por Neon para el desarrollo local o una vista previa, de modo que las pruebas nunca toquen los datos reales.

Cuentas y seguridad

autenticación authentication: Comprobar quién es una persona cuando se registra o inicia sesión, gestionado en el stack por defecto mediante Better Auth.
sesión session: El estado de sesión iniciada guardado en una cookie segura del navegador para que tu app recuerde quién ha entrado al pasar de una página a otra.
secreto secret: Todo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en .env.local.
clave de API API key: Una contraseña que usa tu app con otro servicio. Quien la tenga puede gastar tu dinero.
variable de entorno environment variable: Un hueco con nombre, como TOKENTIDE_API_KEY, que guarda un ajuste o un secreto fuera de tu código.
.env.local .env.local: El archivo oculto de la carpeta de tu proyecto que guarda las variables de entorno en tu equipo para el desarrollo local, ignorado por Git.
límite de uso rate limit: Un tope de cuántas veces se puede hacer algo, como intentos de inicio de sesión por minuto, para frenar abusos.
CSRF CSRF: Falsificación de petición entre sitios (CSRF): un engaño en el que otra web intenta que tu navegador envíe una acción a tu app aprovechando tu sesión abierta.
CSP (política de seguridad de contenidos) CSP (Content Security Policy): Una cabecera de seguridad que tu servidor envía al navegador indicando exactamente qué orígenes de scripts, imágenes y estilos tienen permiso para ejecutarse en tu página.

IA

modelo model: El sistema de IA que produce las respuestas, como el que hay detrás de tu agente.
prompt prompt: El mensaje que le das a un modelo de IA. Un prompt claro da mejores resultados.
token token: Un fragmento pequeño de texto —aproximadamente tres cuartas partes de una palabra— que los proveedores de IA usan para medir y cobrar el prompt que envías y la respuesta que recibes.
proveedor provider: Un servicio que ejecuta modelos de IA y responde a las peticiones de API de tu backend, como Tokentide o Vercel AI Gateway.
respaldo (fallback) fallback: Una alternativa que responde cuando el proveedor principal no puede, para que tu app siga funcionando.
alucinación hallucination: Cuando una IA afirma algo falso con seguridad. Por eso compruebas su trabajo.
determinista deterministic: El código tradicional que sigue reglas exactas: ante la misma entrada, produce exactamente el mismo resultado siempre.
probabilístico probabilistic: Cómo funcionan los modelos de IA: predicen las palabras más probables, por lo que un mismo prompt puede dar respuestas algo distintas y cometer errores ocasionales.

Publicar

publicar (desplegar) deploy: Poner una versión de tu app en internet.
build (compilación) build: El paso en el que Next.js comprueba tu código y empaqueta tus páginas y componentes en una versión rápida y lista para servir antes de publicarla.
Vercel Vercel: El servicio que convierte tu código de GitHub en una web publicada, con una vista previa para cada cambio.
vista previa (Preview) Preview: Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.
producción (Production) Production: La versión publicada de tu app, la que ve todo el mundo. Sale de main.
entorno environment: El lugar donde se ejecuta una versión de tu app: desarrollo (en tu equipo), vista previa (un enlace de prueba en Vercel) o producción (la web pública).
volver a una versión anterior rollback: Volver a poner en línea la versión anterior que funcionaba, con un clic, mientras se arregla el problema.

Errores

error (bug) bug: Un fallo en el código que hace que la app se comporte mal.
mensaje de error error message: Lo que dice un programa cuando algo falla. La primera línea suele decir qué; el resto dice dónde.
traza de error (stack trace) stack trace: La lista de pasos que llevaron a un error. Útil para tu agente; nunca se enseña a tus usuarios.
log (registro) log: El diario de tu app: una línea por evento. Cuando algo se rompe, los logs cuentan qué pasó.
consola console: El lugar del navegador donde aparecen los mensajes y errores de tu app.
depuración debugging: Encontrar y arreglar la causa de fondo de un error: reproducir, encontrar, arreglar, comprobar.
límite de error (error boundary) error boundary: Una red de seguridad de tu app que atrapa errores inesperados y muestra un mensaje amable con «Reintentar».
código de referencia reference id: Un código breve que se muestra en un mensaje de error amable y se anota en el log del servidor, para que tu agente localice el evento exacto sin exponer detalles técnicos al usuario.
supervisión monitoring: Vigilar el funcionamiento de tu app publicada con herramientas como Sentry y logs estructurados para saber si los usuarios reales encuentran algún fallo.
alerta alert: Un aviso automático —como un correo de Sentry o un aviso de saldo de Tokentide— que se envía cuando algo requiere tu atención.

Método

agente de programación coding agent: Una IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.
instrucciones globales global instructions: Un archivo de texto que tu agente lee al empezar cada sesión, en todos los proyectos. La guía de Agentic Makers es uno.
skill skill: Una guía experta que sigue tu agente para un tipo de tarea, como escribir una especificación o depurar.
especificación spec: SPEC.md: qué vas a construir, para quién, qué entra y qué no, y cómo sabrás que funciona.
plan plan: La especificación dividida en tareas pequeñas, cada una terminada y comprobable por sí sola, en tasks/plan.md.
tarea task: Un paso pequeño e independiente de tu plan y de la lista tasks/todo.md que se construye en su propia rama, se comprueba en el navegador y se marca como hecho.
desarrollo guiado por especificaciones (SDD) spec-driven development (SDD): Acordar qué construir (la especificación) y un plan, y después construir un paso pequeño y comprobado cada vez.
ingeniería agéntica agentic engineering: Construir software dirigiendo agentes de IA y comprobando su trabajo: tú diriges, el agente construye.
experimento rápido quick experiment: Una prueba desechable sin especificación. Sirve para probar una idea, nunca para algo que vayas a publicar.

¿Te ha resultado útil esta página?

Última revisión 8 nov 2026