Glosario de Terminologia

Glosario de Terminologia

Para que sirve: Traduccion y explicacion de terminos tecnicos en ingles que aparecen constantemente en el desarrollo de software y en el trabajo con Claude.

Organizado por temas. Cada termino incluye: que significa literalmente, que significa en nuestro contexto, y un ejemplo practico.

Metodo de trabajo con Claude

Harness (arnes)

Literalmente un arnes, como el de un caballo. En nuestro contexto es todo lo que rodea a Claude para que trabaje bien: las reglas, los controles, las memorias, los limites. Sin harness, Claude improvisa. Con harness, Claude sigue el camino correcto.

Ejemplo: “El pre-commit hook es parte del harness — valida el codigo antes de que se guarde.”

Footgun (pistola apuntando al pie)

Un error que parece inofensivo pero te hace dano. Lo usamos para documentar errores tecnicos que ya nos han pasado y que Claude debe recordar para no repetirlos.

Ejemplo: “Poner CONN_MAX_AGE distinto de 0 con Daphne es un footgun — la app parece funcionar pero a las pocas horas la base de datos se satura.”

Context cascading (contexto en cascada)

La forma en que Claude recibe informacion en capas, de lo mas general a lo mas especifico: primero las reglas del proyecto (CLAUDE.md), luego las de tu modulo (agents/), luego tus memorias personales, y finalmente consultas bajo demanda (Biblioteca). Cada capa anade detalle sin repetir lo anterior.

Ejemplo: “Claude sabe que el proyecto usa Django (CLAUDE.md), que el modulo de monitoring tiene 130 endpoints (agent), que a ti no te gusta que resuma al final (memoria), y que el modelo AIInsight tiene 20 campos (Biblioteca).”

Feedforward (alimentacion hacia adelante)

Informacion que le damos a Claude antes de que actue para guiarlo. Son las instrucciones preventivas: “haz esto asi”, “no hagas aquello”.

Ejemplo: “El CLAUDE.md es feedforward puro — le dice a Claude como trabajar antes de que escriba una sola linea.”

Feedback (retroalimentacion)

Informacion que obtenemos despues de que Claude actua para corregirlo. Son los controles que verifican si lo que hizo esta bien.

Ejemplo: “El pre-commit hook es feedback — despues de que Claude escribe codigo, verifica que no tenga errores de seguridad.”

Sensor

Un control que verifica algo automaticamente. Hay dos tipos:

• Computacional: rapido, barato, siempre da el mismo resultado (un test, un linter)
• Inferencial: lento, costoso, usa juicio (otro modelo de IA revisando, o un humano)

Ejemplo: “El pre-commit hook es un sensor computacional. Tu revisando el codigo en produccion eres un sensor inferencial.”

Guide (guia)

En el contexto de Harness Engineering, es cualquier cosa que orienta a Claude antes de actuar: CLAUDE.md, memorias, prompts del sistema, whitelists de comandos.

Ejemplo: “El system prompt de CNS que le dice ‘nunca sugieras reload’ es un guide.”

Human-in-the-loop (humano en el bucle)

Un diseno donde el humano siempre tiene la ultima palabra. Claude propone, tu decides. Nunca ejecucion automatica de cosas importantes.

Ejemplo: “CNS diagnostica un problema de red y sugiere comandos, pero no los ejecuta hasta que el operador pulsa ‘Apply’.”

Guardrail (barrera de seguridad)

Limites que evitan que Claude haga algo peligroso. Como las barreras de una carretera de montana — no te dicen por donde ir, pero evitan que caigas.

Ejemplo: “La lista de comandos bloqueados (reload, erase, format) es un guardrail del CNS.”

Desarrollo de software

Overhead (sobrecarga)

Trabajo extra que no produce valor directo pero es necesario para mantener el sistema. Cuanto menos overhead, mejor.

Ejemplo: “Mantener tres repos en vez de dos anade overhead de sincronizacion.”

Stack (pila tecnologica)

El conjunto de tecnologias que usamos en el proyecto. “Nuestro stack” = Django + PostgreSQL + Valkey + Docker + HTMX.

Ejemplo: “El stack de CreaRack incluye 15 tecnologias principales.”

Framework (marco de trabajo)

Una estructura base que te da el 80% resuelto y tu solo pones el 20% especifico de tu proyecto. Django es un framework: te da usuarios, base de datos, admin… y tu solo pones la logica de racks y monitoring.

Runtime (entorno de ejecucion)

El programa que ejecuta tu codigo. Python 3.14 es nuestro runtime — es el “motor” que hace funcionar el codigo Django.

Endpoint (punto de acceso)

Una URL de la API a la que puedes hacer peticiones. Cada endpoint hace una cosa concreta.

Ejemplo: “GET /api/racks/ es un endpoint que devuelve la lista de racks. Tenemos 512.”

API (interfaz de programacion)

La “puerta” por la que los programas hablan entre si. Cuando el navegador muestra tus racks, esta pidiendo datos a la API.

Pipeline (tuberia)

Una secuencia de pasos que se ejecutan en orden, uno tras otro. Los datos entran por un lado y salen procesados por el otro.

Ejemplo: “Auto-Provision tiene un pipeline de 6 etapas: ping → SNMP → SSH → LLDP → stencil match → confidence score.”

Fallback (plan B)

Lo que se ejecuta cuando el plan A falla. Es la alternativa de respaldo.

Ejemplo: “Si Gemini no responde, el fallback es Claude Haiku. Si ese tampoco, el fallback final son las reglas estaticas.”

Rollback (deshacer)

Volver al estado anterior despues de un cambio que salio mal. Como el Ctrl+Z pero para servidores.

Ejemplo: “Si un comando de CNS empeora las cosas, el rollback ejecuta los comandos inversos.”

Deploy (desplegar)

Poner codigo nuevo en el servidor de produccion para que los usuarios lo vean.

Ejemplo: “Despues de hacer push, Dokploy hace el deploy automaticamente.”

Staging (entorno de pruebas)

Una copia del servidor de produccion donde probar cambios sin afectar a los usuarios reales. Nuestro staging es el servidor 178.104.131.173.

Cache (memoria rapida)

Un almacen temporal que guarda datos frecuentes para no tener que calcularlos cada vez. Valkey es nuestra cache.

Ejemplo: “Los learned patterns del CNS se guardan en cache 6 horas para no recalcularlos en cada anomalia.”

Token

Dos significados segun el contexto:

• Seguridad: Una clave temporal que demuestra que tienes permiso (como una tarjeta de acceso)
• IA: Una unidad de texto que el modelo procesa (una palabra suele ser 1-2 tokens)

Middleware (intermediario)

Codigo que se ejecuta entre la peticion del usuario y tu logica. Como un portero que verifica la entrada antes de dejarte pasar.

Ejemplo: “El rate limit middleware cuenta cuantas peticiones hace cada organizacion y bloquea si son demasiadas.”

Git y control de versiones

Repo / Repository (repositorio)

La carpeta del proyecto con todo su historial de cambios. Tenemos tres: CreaRack-Pro, CreaRackSL-workspace y claude-method.

Commit (confirmar)

Guardar un punto en el historial. Como hacer una foto del estado actual del codigo con un mensaje que explica que cambiaste.

Push (empujar)

Subir tus commits al servidor de GitHub para que el equipo los tenga.

Pull (tirar)

Descargar los cambios que otros han subido a GitHub.

Rebase (rebasar)

Reorganizar tu historial de commits para que quede limpio encima de lo ultimo del equipo. Es como “ponerse al dia” antes de compartir tu trabajo.

Ejemplo: “git pull --rebase origin main — obligatorio antes de cada push.”

Branch (rama)

Una linea de desarrollo paralela. Permite trabajar en algo sin afectar al codigo principal.

Ejemplo: “edu/signage es una branch donde Edu trabaja en el modulo de signage sin molestar a Dani.”

Merge (fusionar)

Unir una branch con la rama principal (main) cuando el trabajo esta listo.

Hook (gancho)

Un script que se ejecuta automaticamente cuando pasa algo en git.

Ejemplo: “El pre-commit hook se ejecuta justo antes de cada commit y valida el codigo.”

CI/CD (integracion/despliegue continuo)

Sistema automatico que compila, prueba y despliega el codigo cada vez que haces push. GitHub Actions es nuestro CI.

Ejemplo: “Usamos [skip ci] en commits de documentacion para no gastar minutos de CI innecesariamente.”

Inteligencia Artificial

LLM (modelo de lenguaje grande)

El “cerebro” de Claude, Gemini, GPT, etc. Un programa entrenado con enormes cantidades de texto que puede entender y generar lenguaje.

Prompt (instruccion)

El texto que le envias al modelo para que haga algo. Puede ser una pregunta, una orden, o contexto.

Context window (ventana de contexto)

La cantidad maxima de texto que el modelo puede “recordar” en una conversacion. Como la memoria de trabajo de una persona — si le das demasiada informacion, olvida el principio.

Ejemplo: “CLAUDE.md + memorias + agents ocupan ~80KB de la ventana de contexto. La Biblioteca evita llenarla porque consulta bajo demanda.”

Embedding (representacion vectorial)

Una forma de convertir texto en numeros para que el ordenador pueda comparar si dos textos hablan de lo mismo. La Biblioteca usa embeddings para buscar documentacion por significado, no solo por palabras exactas.

Ejemplo: “Buscar ‘como configurar el monitoring’ encuentra documentos que hablan de ‘setup del observatorio’ aunque no usen las mismas palabras.”

Inference (inferencia)

Cuando el modelo genera una respuesta. Cada vez que Claude te contesta, esta haciendo inferencia. Cuesta dinero y tiempo.

Temperature (temperatura)

Cuanto “riesgo creativo” toma el modelo al responder. Temperatura baja (0.2) = respuestas predecibles y seguras. Temperatura alta (0.8) = respuestas mas creativas pero menos fiables.

Ejemplo: “CNS usa temperatura 0.2 porque queremos diagnosticos fiables, no creativos.”

MCP (Model Context Protocol)

El protocolo que permite a Claude conectarse con herramientas externas. Es como darle a Claude un telefono para llamar a otros servicios.

Ejemplo: “Via MCP, Claude puede consultar la Biblioteca, crear tareas en el workspace, o ver el estado de los servidores.”

Arquitectura y patrones

SaaS (software como servicio)

Software que vive en la nube y se paga por suscripcion en vez de instalarlo en tu ordenador. CreaRack Pro es SaaS.

Multi-tenant (multi-inquilino)

Un solo servidor que sirve a multiples clientes, cada uno viendo solo sus datos. Como un edificio de apartamentos: todos comparten el edificio pero cada uno tiene su piso privado.

Async / Asynchronous (asincrono)

Operaciones que no esperan a terminar para seguir. Como enviar un email: no te quedas mirando la pantalla hasta que llega — sigues trabajando y te avisan cuando responden.

Ejemplo: “Las consultas SNMP son async — lanzamos 20 en paralelo sin esperar a que cada una termine.”

Refactor (reestructurar)

Cambiar como esta organizado el codigo sin cambiar lo que hace. Como reorganizar un armario: la ropa es la misma pero ahora encuentras todo mas rapido.

Technical debt (deuda tecnica)

Atajos que tomaste para ir rapido y que algun dia tendras que arreglar. Como barrer la suciedad debajo de la alfombra — funciona hoy pero manana tendras un problema mayor.

Anti-pattern (anti-patron)

Una solucion que parece buena pero que en realidad causa problemas. Lo contrario de una buena practica.

Ejemplo: “Crear un helper para algo que solo se usa una vez es un anti-pattern — anade complejidad sin beneficio.”

Boilerplate (plantilla repetitiva)

Codigo que siempre es igual y hay que escribir en cada proyecto. Los templates de claude-method eliminan boilerplate.

Breaking change (cambio que rompe)

Un cambio que hace que lo que funcionaba antes deje de funcionar.

Ejemplo: “Borrar una columna de la base de datos es un breaking change si la version anterior del codigo todavia la usa.”

Deprecated (obsoleto)

Algo que todavia funciona pero que se va a eliminar en el futuro. Aviso de “esto va a desaparecer, deja de usarlo”.

Ejemplo: “gemini-2.0-flash esta deprecated — hay que usar gemini-3-flash-preview.”

Scope (alcance)

Los limites de lo que incluye algo. “Dentro de scope” = es tu responsabilidad. “Fuera de scope” = no te toca.

Ejemplo: “El agente dev-backend tiene en scope las APIs y modelos. El frontend esta fuera de scope.”

Edge case (caso limite)

Una situacion poco comun pero posible que puede causar errores si no la consideras.

Ejemplo: “Que pasa si un dispositivo tiene 0% de packet loss pero el SNMP no responde? Ese es un edge case.”

Infraestructura

Container (contenedor)

Una caja aislada donde corre un programa con todo lo que necesita. Docker crea contenedores. Es como una maquina virtual pero mas ligera.

Ejemplo: “Tenemos 6 contenedores en produccion: web, worker, cache, db, pgbouncer, victoriametrics.”

Broker (intermediario de mensajes)

Un servicio que recibe tareas y las distribuye a los trabajadores. Valkey es nuestro broker — recibe tareas de la web y las entrega al worker (Huey).

Rate limiting (limitacion de velocidad)

Controlar cuantas peticiones puede hacer alguien en un periodo de tiempo. Evita abusos y sobrecarga.

Ejemplo: “Maximo 5 insights CNS por dispositivo por hora. Si se supera, se bloquean los nuevos.”

Webhook

Una notificacion automatica que un servicio envia a otro cuando pasa algo. Como un timbre que suena cuando llega un paquete.

Ejemplo: “GitHub envia un webhook a Dokploy cada vez que hacemos push, y Dokploy despliega automaticamente.”

ITSM (gestion de servicios IT)

El sistema que gestiona incidentes, SLAs y escalaciones. En CreaRack, el modulo CNS tiene funciones ITSM integradas.

SLA (acuerdo de nivel de servicio)

Un compromiso de tiempo maximo para responder o resolver un problema. Si se supera, se “incumple el SLA”.

Ejemplo: “Un insight HIGH tiene SLA de 15 minutos para ser reconocido. Si nadie lo mira en ese tiempo, se escala.”

Uso rapido

Cuando no recuerdes un termino, busca aqui o pregunta a Claude:

"Que significa [termino] en nuestro contexto?"

Claude tiene instrucciones de explicar la jerga la primera vez que la use.

Véase también

• [[workspace—guias—como-trabajamos]]