Glosario de las guías técnicas

A

Acceso de emergencia break-glass

Un acceso excepcional a producción que se usa sólo en una emergencia, queda registrado y se audita después. No es la vía normal de trabajo.

ADR Architecture Decision Record

Un documento corto que registra una decisión de arquitectura, por qué se tomó y qué alternativas se descartaron. Sirve para que nadie, ni persona ni agente, cambie esa decisión sin saberlo.

Agente de codificación coding agent

Una herramienta de IA que puede leer un repositorio, escribir o modificar código y correr comandos, siempre dentro de los permisos que le da el equipo. Por ejemplo, Cursor o Claude Code.

Agente de inventario

El agente que, en una migración, analiza una porción del sistema anterior y documenta sus campos, validaciones, reglas, integraciones y persistencia antes de que se escriba código nuevo.

Análisis estático de seguridad SAST

Una revisión automática del código, sin ejecutarlo, que busca vulnerabilidades conocidas como inyecciones o manejo inseguro de datos.

API Application Programming Interface

La forma en que un sistema ofrece sus funciones a otros programas. Cada operación concreta de una API es un endpoint.

Artefacto artifact

Lo que produce un proceso de construcción y se guarda para usarse después, como un paquete, una imagen de contenedor o un reporte de pruebas.

Auditor

El rol del ciclo de agentes que revisa el trabajo del Implementador con un contexto limpio, sin conocer su razonamiento. Corre las pruebas, revisa el código y entrega un veredicto de cumple o no cumple.

Autenticación y autorización authentication · authorization

La autenticación comprueba quién eres; la autorización decide qué puedes hacer. Se revisan por separado porque un error en cualquiera de las dos expone datos.

B

Brecha gap

Algo que debería estar y falta. En una migración, una regla del inventario que no tiene código o prueba que la respalde.

C

Caché cache

Una copia temporal de un resultado para no calcularlo o consultarlo cada vez. Acelera el sistema, pero hay que decidir cuándo se renueva.

CI/CD Continuous Integration / Continuous Delivery

La integración y la entrega continuas. Son los procesos automáticos que, con cada cambio, corren las pruebas y verificaciones (CI) y preparan o despliegan la nueva versión (CD).

Ciclo de agentes O–I–A, O–I–F–A, Coordinator–Implementor–Verifier (CIV)

La forma en que se reparte el trabajo entre roles. En un proyecto nuevo son el Orquestador, el Implementador y el Auditor. En una migración se agrega la Fuente de verdad entre el Implementador y el Auditor. Algunos equipos lo abrevian con las iniciales de los roles, O–I–A u O–I–F–A.

Cobertura de pruebas test coverage

Qué parte del código se ejecuta al correr las pruebas. Una cobertura alta ayuda, pero no garantiza que se prueben los casos importantes.

Commit

Un cambio guardado en el historial del repositorio, con un mensaje que explica qué se hizo. Es el primer punto donde se revisan secretos, estilo y pruebas rápidas.

Contenedor container

Un paquete que incluye una aplicación con todo lo que necesita para correr, aislado del resto de la computadora. Así funciona igual en cualquier equipo.

Contexto limpio

Revisar un trabajo sin heredar la conversación ni el razonamiento de quien lo hizo. Así el Auditor no se deja llevar por el relato del autor.

Contrato contract

La definición de lo que un servicio o API recibe y devuelve. Si el contrato cambia, quien lo consume también puede verse afectado.

Copiar tal cual lift-and-shift

Llevar un sistema a una tecnología o plataforma nueva sin rediseñarlo. Es rápido, pero arrastra la deuda y los malos patrones del sistema anterior.

Criterios de aceptación acceptance criteria

Las condiciones concretas que debe cumplir una tarea para que se acepte, escritas de forma que se puedan comprobar.

D

Definición de terminado Definition of Done, DoD

La lista acordada de condiciones que una tarea debe cumplir para darse por terminada, como pruebas en verde, lint sin errores y revisión aprobada. No depende de la opinión de nadie.

DEV (marca en las guías)

En nuestras guías, la marca DEV señala lo que sólo hace o decide una persona del equipo, nunca un agente.

Devcontainer y Compose Dev Containers · Docker Compose

Formas de describir en archivos el entorno de desarrollo completo (lenguaje, herramientas y servicios) para que cualquier persona o agente lo cree igual con un comando.

DLP Data Loss Prevention

La prevención de fuga de datos. Son reglas que detectan y bloquean o enmascaran información sensible, como datos personales o secretos, antes de que salga hacia una herramienta externa.

DNS Domain Name System

El sistema que traduce un nombre de dominio, como quarksoft.net, a la dirección del servidor que lo atiende. Un cambio equivocado puede dejar un sitio fuera de línea.

DORA DevOps Research and Assessment

Un programa de investigación que estudia cómo entregan software los equipos. Sus estudios muestran que adoptar IA sin controles suele aumentar la velocidad y también la inestabilidad.

E

Endpoint

Una dirección concreta de una API que realiza una operación, por ejemplo consultar un recibo o registrar una póliza.

Entorno de ejecución runtime

Todo lo que necesita el código para correr. Incluye el lenguaje, sus librerías y los servicios de los que depende.

Espacio de trabajo workspace

La copia local del proyecto donde una persona o un agente trabaja. No debe contener secretos reales.

Estructura inicial scaffold

El esqueleto con el que arranca un proyecto o un módulo (carpetas, archivos base, pruebas de ejemplo), generado a partir de la plantilla.

F

Fuente de verdad source of truth

En una migración, el rol del ciclo de agentes que compara lo construido con el inventario de reglas. Comprueba que el negocio se comporte igual y que se use la arquitectura nueva.

G

Gateway hacia los modelos API gateway, LLM gateway

Un punto único por el que pasan todas las peticiones a los modelos de IA. Ahí se aplican la DLP, la lista de herramientas permitidas y el registro de prompts.

Gitleaks

Una herramienta que revisa el repositorio en busca de secretos (contraseñas, tokens, claves) y detiene el commit si encuentra alguno.

H

Hallazgo finding

Un problema que encuentra una revisión, con lo necesario para reproducirlo y corregirlo.

I

Idempotencia idempotency

Que repetir una misma operación no cambie el resultado. Por ejemplo, que reenviar un pago por error no cobre dos veces.

Implementador

El rol del ciclo de agentes que escribe el código y las pruebas siguiendo la plantilla, el plan del Orquestador y la definición de terminado.

Integración merge

Unir los cambios de una rama con la rama principal. En nuestras guías sólo ocurre cuando todas las verificaciones pasaron y, si el cambio es de riesgo, una persona lo aprobó.

Inventario de reglas de negocio

El documento que, antes de migrar una porción, recoge sus reglas con evidencia del sistema anterior, su criticidad y sus casos de prueba. Es la referencia de lo que debe seguir funcionando.

J

JWT JSON Web Token

Un formato de credencial firmada que usan muchas aplicaciones para recordar quién inició sesión y qué permisos tiene.

L

Límites entre dominios bounded contexts

Las fronteras que separan las partes de un sistema que hablan de cosas distintas (por ejemplo, cobranza y catálogo), para que un cambio en una no rompa la otra.

Lint

Una revisión automática del estilo y de errores comunes en el código, que ayuda a que todo el equipo escriba de forma consistente.

M

Marco de trabajo framework

Un conjunto de librerías y convenciones sobre el que se construye una aplicación, como Spring, .NET o Angular. Define buena parte de su estructura.

Matriz de trazabilidad

Una tabla que relaciona cada regla de negocio con el código que la implementa y la prueba que la demuestra. Una fila incompleta es una brecha.

Middleware

Una capa de código que procesa cada petición antes de que llegue a la lógica de negocio, por ejemplo para validar la sesión o registrar la actividad.

Mínima autonomía least agency

Darle al agente sólo las herramientas y permisos que necesita para una tarea. Si se equivoca, el daño queda acotado.

Modelo de amenazas threat model

Un análisis temprano de qué podría atacar un sistema, por dónde y con qué impacto, para decidir qué controles necesita.

Monolito monolith

Un sistema construido como una sola pieza grande, donde muchas funciones comparten el mismo código y base de datos.

O

Observabilidad observability

La capacidad de entender qué pasa dentro de un sistema en operación gracias a sus logs, trazas y métricas.

Orquestador

El rol del ciclo de agentes que planea la tarea, fija cuántos intentos hay, decide cómo se reportan los hallazgos y sólo cierra cuando la revisión aprueba.

OWASP Open Worldwide Application Security Project

Una comunidad abierta que publica las buenas prácticas de seguridad en aplicaciones más usadas en la industria.

P

Paralelizar fan-out

Poner a varios agentes a trabajar al mismo tiempo en piezas distintas. Sólo conviene cuando esas piezas no dependen entre sí.

Paridad parity

Que el sistema nuevo se comporte igual que el anterior en lo que importa al negocio, comprobado con pruebas.

Persistencia persistence

Cómo y dónde guarda un sistema su información para que no se pierda, por ejemplo en una base de datos.

PLAN.md y evidence/

El archivo y la carpeta donde se guardan el plan de cada tarea, su estado y la evidencia de las pruebas. Funcionan como la memoria del trabajo, para no depender del chat.

Plantilla template, baseline

El proyecto base que define la arquitectura, los requerimientos no funcionales, las políticas y las herramientas antes de que se escriba código. Es la base del código generado.

Porción slice

Una parte acotada de un sistema que se migra de una vez, como una pantalla, un módulo o un conjunto de APIs.

Pre-commit

Las revisiones automáticas que corren en la computadora de quien trabaja justo antes de guardar un commit, como la búsqueda de secretos o el lint.

Prompt

Las instrucciones que se le dan a un modelo o agente de IA. En nuestras guías, el prompt de tarea siempre lo escribe una persona del equipo.

Pruebas unitarias, de integración y de contrato unit · integration · contract tests

Las unitarias revisan una pieza pequeña de código por separado; las de integración, que varias piezas funcionen juntas; las de contrato, que un servicio siga recibiendo y devolviendo lo acordado.

Puerta de control gate

Un punto del proceso donde el trabajo se detiene hasta cumplir ciertas condiciones, por ejemplo tener el inventario aprobado o las pruebas en verde.

Push

Enviar los commits locales al repositorio compartido. Es otro punto donde se revisan secretos, dependencias nuevas y exposición de datos.

Q

QA Quality Assurance

El aseguramiento de la calidad. También se llama así al ambiente de pruebas donde se valida un cambio antes de producción.

R

Rama branch

Una línea de trabajo separada dentro de un repositorio de Git. Permite hacer cambios sin afectar la versión principal hasta integrarlos.

Rama protegida protected branch

Una rama, normalmente la principal, en la que no se puede integrar nada sin pasar las verificaciones obligatorias y las aprobaciones definidas. Aplica igual para personas y agentes.

Registros logs

Los mensajes que un sistema va guardando sobre lo que hace y los errores que encuentra. Junto con las trazas y las métricas, son la base de la observabilidad.

Regresión regression

Algo que funcionaba y dejó de funcionar por un cambio nuevo. Las pruebas de regresión existen para detectarlo a tiempo.

Requerimientos no funcionales NFR, Non-Functional Requirements

Lo que el sistema debe cumplir además de sus funciones, como la seguridad, el desempeño, la arquitectura o la observabilidad.

Reversión rollback

Regresar a la versión anterior de un sistema cuando un cambio causa problemas. Siempre debe haber una forma documentada de hacerlo.

S

Secretos secrets

Contraseñas, tokens y claves que dan acceso a sistemas. Nunca van en el código ni en un prompt, y el agente nunca recibe los de producción.

Sistema anterior legacy, legado

El sistema existente que se va a modernizar. En una migración es la evidencia del negocio, no el modelo de cómo construir lo nuevo.

SLO Service Level Objective

Un objetivo de servicio medible, por ejemplo que una pantalla responda en menos de un segundo el 99% de las veces.

Solicitud de cambios (PR) pull request, merge request, change request

La petición formal para integrar los cambios de una rama en la rama principal. Ahí se revisan el código, las pruebas y la evidencia antes de aprobarlos. Se le suele decir PR.

Subagente subagent

Un agente que lanza el Orquestador para una parte del trabajo, con su propio contexto. El Auditor suele trabajar así.

T

Tipado typing

Declarar qué tipo de dato maneja cada parte del código (número, texto, fecha…), para que muchos errores se detecten antes de ejecutarlo.

Token

Tiene dos usos en las guías. Como credencial, es una clave temporal que da acceso a un sistema y se trata como secreto. En los modelos de IA, es la unidad en que se mide el texto que procesan, y con ella se calcula su costo.

Trazas traces

El recorrido de una petición por los distintos servicios de un sistema, con cuánto tardó cada paso. Ayudan a encontrar dónde falla o se hace lenta.

W

Worktree

Una copia de trabajo adicional de Git, ligada a su propia rama, que permite trabajar varias tareas a la vez sin mezclar sus cambios.