Glosario
123 palabras del oficio, cada una con su analogía, un ejemplo y una pregunta. Responde bien la pregunta de una ficha y su estrella se enciende.
.gitignore
un archivo de texto con la lista de cosas que Git debe ignorar: no las versiona ni las sube nunca.
Git y GitHub · Fase 1Agente de IA
un modelo de lenguaje al que se le dan herramientas para actuar: en lugar de solo decirte qué hacer, lo hace.
La IA por dentro · Fase 1Alcance
la frontera de un trabajo: lo que entra y, con la misma claridad, lo que no entra.
El método · Fase 2Alucinación
cuando la IA se inventa algo —un dato, una función, una opción, un paquete— y lo presenta con la misma seguridad que si fuera cierto.
La IA por dentro · Fase 2API
la ventanilla por la que dos programas se hablan: pides datos o acciones de una forma acordada y te responden.
El código · Fase 0Archivo de configuración
un archivo de texto donde se apuntan los ajustes de un programa o de un proyecto, para no tener que decírselos cada vez.
El ordenador por dentro · Fase 1Atajo de teclado
una combinación de teclas que hace algo de golpe, sin buscarlo en un menú.
Herramientas · Fase 0Autenticación
comprobar quién eres: el proceso de "iniciar sesión" con el que un programa confirma que eres quien dices ser.
Qué se vende · Fase 0Backend
la parte que el usuario no ve: se ejecuta en el servidor, guarda la información y decide qué se puede hacer y quién puede hacerlo.
El código · Fase 0Base de datos
el sitio organizado donde un programa guarda su información para poder buscarla, cambiarla y relacionarla.
El código · Fase 0Bug
un fallo en un programa: hace algo distinto de lo que debería.
El oficio · Fase 0Buscador
una web que tiene un índice enorme de otras webs y te devuelve las que mejor encajan con lo que escribes. Google es el más usado.
La red · Fase 0Centro de datos
un edificio lleno de servidores encendidos día y noche, con todo lo necesario para que no se apaguen nunca.
La red · Fase 0Cifrado
transformar un mensaje en algo ilegible para todos menos para quien tiene la llave para deshacerlo.
La red · Fase 0Claude
el modelo de lenguaje de la empresa Anthropic, y la IA con la que trabajas en todo este roadmap.
La IA por dentro · Fase 0Claude Code
Claude funcionando como agente en tu terminal: además de conversar, lee tus archivos, los edita y ejecuta comandos en la carpeta donde lo arrancas, pidiéndote permiso.
Herramientas · Fase 1CLAUDE.md
un archivo Markdown en la raíz del proyecto con las instrucciones permanentes para Claude: qué es el proyecto, cómo trabajar en él y qué reglas seguir. Claude Code lo lee al empezar cada sesión.
Herramientas · Fase 1Cliente-servidor
el reparto de papeles de toda la web: un lado pide (el cliente) y otro lado sirve (el servidor).
La red · Fase 0CMS (gestor de contenidos)
un panel que permite al dueño del negocio cambiar textos, fotos y publicar artículos sin tocar código y sin llamarte.
Qué se vende · Fase 0Código abierto
código publicado para que cualquiera pueda verlo, usarlo y mejorarlo, normalmente gratis.
El oficio · Fase 0Código de estado
el número de tres cifras con el que un servidor resume cómo fue una petición: bien, movido, culpa tuya o culpa mía.
La red · Fase 0Código fuente
el texto con las instrucciones de un programa, escrito por personas (o por una IA) y legible por personas.
El código · Fase 0Código QR
un cuadrado de puntos que guarda un texto —normalmente una dirección web— y que la cámara del móvil lee para abrirla sin escribir nada.
Qué se vende · Fase 2Comando
una orden escrita en la terminal: el nombre de un programa seguido de lo que quieres que haga.
El ordenador por dentro · Fase 1Commit
una foto guardada del proyecto en un momento concreto, con un mensaje que explica qué cambió y por qué.
Git y GitHub · Fase 1Contexto
todo lo que la IA tiene delante en un momento dado para responder: tus mensajes, los archivos que leyó, el CLAUDE.md, el error que le pegaste. Lo que no está en el contexto, no existe para ella.
La IA por dentro · Fase 2Control de versiones
un sistema que guarda el historial completo de un proyecto —qué cambió, cuándo, quién y por qué— y permite volver a cualquier punto.
Git y GitHub · Fase 1Copia de seguridad
un duplicado de algo importante, guardado en otro sitio, para poder recuperarlo si el original se pierde.
El oficio · Fase 1Criterios de aceptación
la lista de comprobaciones que deciden si un trabajo está terminado y bien. Cada una se responde con sí o con no.
El método · Fase 2CSS
el lenguaje que dice cómo se ve la página: colores, tamaños, tipografías, espacios y colocación de cada cosa.
El código · Fase 0Datos
la información que un programa guarda, mueve o muestra: nombres, precios, fechas, pedidos. Lo que cambia de un negocio a otro aunque el programa sea el mismo.
El código · Fase 0Dependencia
cualquier cosa de la que tu proyecto depende y que no escribiste tú: una librería, una tipografía de Google, un script cargado desde otra web, un servicio externo.
El código · Fase 2Desarrollo asistido por IA
construir software describiendo qué quieres a un modelo de IA que escribe el código, mientras tú decides, revisas y respondes por el resultado.
El oficio · Fase 0Deshacer en Git
las formas de volver atrás con Git, de la más suave a la más peligrosa. Cuál usar depende de hasta dónde había llegado el cambio.
Git y GitHub · Fase 1Despliegue
llevar tu proyecto de tu ordenador a internet para que cualquiera pueda usarlo.
El oficio · Fase 0Deuda técnica
el trabajo que dejas pendiente cuando resuelves algo deprisa o sin entenderlo, y que tendrás que pagar más adelante, con intereses.
El oficio · Fase 0DevTools (herramientas de desarrollador)
las herramientas de inspección que ya trae tu navegador y que te permiten ver y tocar el código de cualquier web en directo.
Herramientas · Fase 0Diff
la lista exacta de lo que ha cambiado entre dos versiones: líneas quitadas en rojo (-) y añadidas en verde (+).
Git y GitHub · Fase 1Dirección IP
el número que identifica a un ordenador dentro de internet, para que la información sepa a dónde tiene que llegar.
La red · Fase 0DNS
la agenda de contactos de internet: traduce nombres que las personas recuerdan (google.com) a la dirección IP que las máquinas necesitan.
La red · Fase 0Documentación
el manual de una tecnología, escrito por quienes la hacen: qué ofrece, cómo se usa y qué opciones tiene.
El oficio · Fase 0Dominio
el nombre que la gente escribe para llegar a tu web (mibarberia.com). Se alquila por años, no se compra para siempre.
La red · Fase 0Editor de código
el programa donde abres, lees y editas el código de un proyecto: un procesador de textos especializado en código.
Herramientas · Fase 1El ciclo de delegación
el método de trabajo de todo este roadmap: siete pasos que se repiten en cada tarea, desde una landing hasta un sistema a medida.
El método · Fase 2Enlace
un texto, botón o imagen que, al pulsarlo, lleva a otra dirección.
El código · Fase 0Entorno local y producción
el mismo proyecto vive en dos sitios: tu ordenador (local), donde puedes romperlo sin consecuencias, y producción, donde lo usan personas reales.
El oficio · Fase 0Especificación
un documento corto que dice qué hay que construir, para quién, con qué límites y cómo se sabrá que está bien, antes de construir nada.
El método · Fase 2Etiqueta
la marca con la que HTML dice qué es cada trozo de contenido: esto es un título, esto un párrafo, esto un enlace.
El código · Fase 2Extensión de archivo
las letras tras el último punto del nombre (.md, .html, .js) que indican qué tipo de contenido tiene un archivo y qué programa debe abrirlo.
El ordenador por dentro · Fase 1Formulario
la parte de una web donde la persona escribe algo y lo envía: un nombre, un email, un pedido.
El código · Fase 0Framework
un esqueleto de proyecto ya montado, con las decisiones difíciles tomadas y unas reglas que tú sigues.
El código · Fase 0Frontend
la parte que el usuario ve y toca, y que se ejecuta en su navegador.
El código · Fase 0Full stack
la persona que se maneja en las dos mitades del producto: lo que ve el usuario (frontend) y lo que hay detrás (backend + base de datos).
El oficio · Fase 0Gestor de paquetes
la tienda de aplicaciones de la terminal: instala, actualiza y desinstala programas con un comando, y se encarga de todo lo que necesitan para funcionar.
El ordenador por dentro · Fase 1Gestor de versiones (mise)
un programa que instala herramientas de desarrollo (Node, gh, claude…) y permite tener varias versiones a la vez, incluso una distinta para cada proyecto.
El ordenador por dentro · Fase 1Git
el programa de control de versiones que usa prácticamente todo el mundo. Funciona en tu ordenador, sin necesidad de internet.
Git y GitHub · Fase 1git status
el comando que responde a "¿cómo está mi proyecto ahora mismo?": qué archivos cambiaron, cuáles están preparados y cuáles ni siquiera conoce Git.
Git y GitHub · Fase 1GitHub
la web donde se alojan repositorios Git para guardarlos, compartirlos y colaborar. Es donde vive la mayor parte del código del mundo.
Git y GitHub · Fase 1Hosting
el alquiler del sitio donde vive tu web para que esté accesible siempre, para todo el mundo.
La red · Fase 0HTML
el lenguaje que dice qué hay en una página: esto es un título, esto un párrafo, esto una imagen, esto un botón.
El código · Fase 0HTTP / HTTPS
el idioma con el que el navegador pide páginas y datos, y el servidor responde.
La red · Fase 0Inteligencia artificial (IA)
programas que hacen tareas que antes solo sabía hacer una persona —entender una pregunta, escribir un texto, programar— porque aprendieron de muchísimos ejemplos en lugar de seguir reglas escritas a mano.
La IA por dentro · Fase 0Interfaz
la parte de un programa con la que tratas tú: lo que ves y lo que puedes tocar para darle órdenes.
Qué se vende · Fase 0Internet
la red mundial de ordenadores conectados entre sí por cables, fibra y antenas, que se pasan información unos a otros.
La red · Fase 0Issue
una tarjeta en GitHub para registrar un problema, una mejora o una tarea pendiente de un proyecto, con su hilo de conversación.
Git y GitHub · Fase 1Iteración
avanzar en vueltas cortas —hacer, revisar, corregir— en lugar de intentar acertar todo a la primera.
El método · Fase 2JavaScript
el lenguaje que hace que una página haga cosas: reaccionar a un clic, validar un formulario, traer datos sin recargar, mostrar un aviso.
El código · Fase 0Landing page
una sola página con un único objetivo: que quien entra haga una cosa concreta (llamar, reservar, comprar, dejar su email).
Qué se vende · Fase 0Lenguaje de programación
el idioma en el que se escriben las instrucciones que un ordenador ejecuta.
El código · Fase 0Librería
un trozo de código ya hecho por otros que resuelve un problema concreto, y que tú usas cuando te hace falta.
El código · Fase 0localhost
el nombre que significa "este mismo ordenador". Una dirección como http://localhost:3000 es una web que está funcionando en tu máquina y que solo tú puedes ver.
La red · Fase 0Markdown
una forma de escribir texto con formato usando símbolos sencillos (# para títulos, ** para negrita) que se lee bien incluso sin convertirlo.
Herramientas · Fase 1Mensaje de error
el aviso que da un programa cuando algo falla: qué falló y, casi siempre, dónde. Es información, no un reproche.
El código · Fase 2Merge (fusión)
juntar los cambios de una rama en otra; normalmente, traer la rama de trabajo a main cuando está lista.
Git y GitHub · Fase 1Modelo de lenguaje (LLM)
un programa entrenado con una cantidad enorme de texto —incluido muchísimo código— que, a partir de lo que le escribes, genera la continuación más probable. Claude es uno.
La IA por dentro · Fase 2Navegador
el programa que pide páginas, entiende su código y lo dibuja en tu pantalla.
La red · Fase 0Node.js
el programa que permite ejecutar JavaScript fuera del navegador: en tu ordenador y en servidores.
Herramientas · Fase 1Obsidian
un programa para tomar apuntes en archivos Markdown guardados en tu propio ordenador, con enlaces entre notas.
Herramientas · Fase 0Página web y sitio web
una página es un documento que el navegador muestra en una dirección concreta; un sitio es el conjunto de páginas de un mismo dominio; y la web es el conjunto de todos los sitios, enlazados entre sí.
La red · Fase 0Panel de administración
la parte privada de una web donde el dueño del negocio entra con su usuario para gestionar: cambiar precios, ver pedidos, marcar un plato como agotado.
Qué se vende · Fase 0Permisos de Claude Code
cuánta libertad le das a Claude Code para actuar sin preguntarte: desde pedir permiso para todo hasta no pedirlo nunca.
Herramientas · Fase 2Permisos del sistema
las reglas que deciden qué puede leer, modificar o ejecutar cada usuario del ordenador.
El ordenador por dentro · Fase 1Petición y respuesta
el intercambio básico de toda la web: alguien pide algo y el otro lado devuelve algo. Y siempre empieza quien pide.
La red · Fase 0Píxel
la unidad con la que se miden las cosas en una pantalla. Se abrevia px.
El código · Fase 2Plan antes de código
pedirle a la IA que primero proponga cómo va a hacer algo —qué archivos, qué decisiones, qué supone— y que no escriba nada hasta que lo apruebes.
El método · Fase 2Plantilla
algo ya hecho, con huecos para rellenar, que sirve de punto de partida en lugar de empezar de cero.
Qué se vende · Fase 0Portfolio
la muestra de trabajos que enseñas para demostrar lo que sabes hacer.
El oficio · Fase 0Programa
una lista de instrucciones que un ordenador sigue, una detrás de otra, para hacer un trabajo.
El código · Fase 0Prompt
el mensaje con el que le pides algo a una IA. Su calidad decide, más que ninguna otra cosa, la calidad de la respuesta.
La IA por dentro · Fase 2Protocolo
un conjunto de reglas acordadas de antemano para que dos máquinas que no se conocen puedan entenderse.
La red · Fase 0Pruebas
comprobar que lo construido hace lo que debe, usándolo de verdad, antes de darlo por bueno.
El oficio · Fase 0Pull request (PR)
una propuesta formal, en GitHub, de fusionar una rama en otra: se ven los cambios, se comentan y se aprueban antes de unirlos.
Git y GitHub · Fase 1Push y pull
push sube tus commits al remoto; pull baja los commits del remoto que tú todavía no tienes.
Git y GitHub · Fase 1Raíz del proyecto
la carpeta principal de un proyecto: la que contiene todo lo demás.
El ordenador por dentro · Fase 1Rama
una línea paralela de trabajo dentro del mismo repositorio, para probar o construir algo sin tocar la versión buena.
Git y GitHub · Fase 1README
el archivo de portada de un repositorio: qué es el proyecto, cómo se arranca y cómo se usa. GitHub lo muestra automáticamente al entrar.
Git y GitHub · Fase 1Remoto
una copia de tu repositorio guardada en otro sitio —normalmente GitHub— con la que sincronizas el tuyo.
Git y GitHub · Fase 1Repositorio
la carpeta de un proyecto con memoria: guarda el proyecto y además todo su historial de cambios.
Git y GitHub · Fase 1Responsive
que una misma web se adapta al tamaño de la pantalla: se lee bien en un móvil pequeño y también en un monitor grande.
El código · Fase 2Revisión de código
examinar un cambio antes de aceptarlo: qué hace, si hace lo que se pidió, si rompe algo y si se entiende.
El método · Fase 2Roles del equipo web
quién hace qué en un proyecto web — y cuáles vas a cubrir tú con ayuda de la IA.
El oficio · Fase 0Ruta de archivo
la dirección de un archivo o carpeta dentro de tu ordenador.
El ordenador por dentro · Fase 1SaaS
software que se usa por internet y se paga por suscripción, compartido por muchos clientes a la vez.
Qué se vende · Fase 0Script
un archivo con instrucciones que se ejecutan una detrás de otra, de arriba abajo. La palabra se usa para dos cosas distintas según dónde aparezca.
El código · Fase 1Secreto
cualquier dato que da acceso a algo y que, por tanto, no puede ver nadie más: contraseñas, claves de servicios, llaves de acceso.
El código · Fase 1Servidor
un ordenador encendido permanentemente, esperando peticiones para responderlas.
La red · Fase 0Sintaxis
las reglas de escritura de un lenguaje: qué símbolos se usan, en qué orden y cómo se cierran.
El código · Fase 0Sistema a medida
software hecho para un negocio concreto, que copia su forma real de trabajar en lugar de obligarle a cambiarla.
Qué se vende · Fase 0Sistema de archivos
la forma en que el ordenador organiza todo lo que guarda: archivos dentro de carpetas, dentro de otras carpetas, formando un árbol.
El ordenador por dentro · Fase 1Sistema operativo
el programa base que gestiona el ordenador (memoria, disco, pantalla, red) y sobre el que funcionan todos los demás programas.
El ordenador por dentro · Fase 1Stack tecnológico
el conjunto de tecnologías que eliges para un proyecto, desde la pantalla hasta los datos.
El oficio · Fase 0Tarea pequeña y verificable
un trozo de trabajo lo bastante pequeño para revisarlo de una vez, y con una forma clara de comprobar que está bien.
El método · Fase 2Terminal
una ventana donde le das órdenes al ordenador escribiendo, en lugar de haciendo clic.
El ordenador por dentro · Fase 1Texto plano
un archivo que contiene solo caracteres —letras, números, símbolos—, sin tipografías, colores ni nada escondido.
El ordenador por dentro · Fase 1Tipografía
el dibujo de las letras de un texto. Cada tipografía es un archivo que el navegador necesita tener para poder pintar las letras con esa forma.
El código · Fase 0Tipos de producto web
no todo lo que un cliente llama "una web" es lo mismo: hay escalas muy distintas, y confundirlas es el error más caro que puedes cometer al presupuestar.
Qué se vende · Fase 0Token
el trozo de texto con el que trabaja un modelo de lenguaje. Los modelos no leen letras ni palabras: leen tokens.
La IA por dentro · Fase 2URL
la dirección completa de algo concreto en internet: no solo el sitio, sino la página exacta y con qué opciones.
La red · Fase 0Usuario
la persona que usa lo que construyes: quien abre la web, lee la carta, pulsa el botón.
Qué se vende · Fase 0Variable de entorno
un dato con nombre que el sistema o un programa lee al arrancar para saber cómo comportarse, sin que esté escrito dentro del código.
El ordenador por dentro · Fase 1Vercel
una plataforma que publica tu web directamente desde tu repositorio de GitHub: cada vez que subes cambios, se despliega sola.
Herramientas · Fase 2Versión
el número que identifica cada edición de un programa. Cada vez que sus autores publican cambios, sube.
Herramientas · Fase 1Web estática y dinámica
una web estática muestra siempre lo mismo hasta que alguien cambia sus archivos; una dinámica cambia según los datos o según quién la visita.
Qué se vende · Fase 2Los términos que más se confunden
| Esto | No es esto |
|---|---|
| dominio (el rótulo) | hosting (el local) |
| internet (las carreteras) | la web (uno de los vehículos) |
| frontend (construir lo visible) | diseño (decidir cómo se ve) |
| cliente (el navegador) | cliente (negocio) (quien paga) |
| framework (la casa prefabricada) | librería (el electrodoméstico) |
| SaaS (uno para muchos) | sistema a medida (uno para uno) |
| JavaScript | Java (no tienen nada que ver) |
| URL (la dirección completa) | dominio (solo una parte) |
| Git (la herramienta, en tu ordenador) | GitHub (la web donde guardas lo que haces con ella) |
| git pull (bajar cambios) | pull request (pedir que acepten los tuyos) |
| commit (guardar en tu ordenador) | push (subirlo a GitHub) |
| terminal (hablas con tu ordenador) | la consola de las DevTools (hablas con una página web) |
| README (para personas) | CLAUDE.md (para la IA) |
| ruta de un archivo (en tu disco) | ruta de una URL (dentro de una web) |
| el modelo (el cerebro: Opus, Sonnet) | Claude Code (las manos: el programa que actúa) |
| especificación (qué se construye; la escribes tú) | plan (cómo lo construirá la IA; lo apruebas tú) |
| alcance (qué entra y qué no) | criterios (cómo se comprueba que está bien) |
main en Vercel (producción: lo ve todo el mundo) |
una rama o PR (vista previa: solo para revisar) |
| navegador (el programa: Chrome, Firefox) | buscador (una web que visitas con él: Google) |
| autenticación (quién eres) | autorización (qué puedes hacer) |
| token (trozo de texto para una IA) | token de acceso (una clave → secreto) |
| página (una hoja, con su URL) | sitio (todas las páginas de un dominio) |
| bug (funciona mal, a veces sin avisar) | error de sintaxis (ni arranca) |
| versión (de una herramienta ajena) | control de versiones (el historial de tu proyecto) |
| copia de seguridad (un estado guardado) | control de versiones (la historia de los cambios) |
| Claude (el modelo) | Claude Code (el programa que le da manos) |